quicker-agent

Command-line tool to get or update HTML for a getquicker.net shared action’s web intro. It uses Playwright with a persistent browser profile, preferring system Chrome or Edge, then bundled Chromium. After the first successful login, cookies are reused until the session expires (then the tool logs in again automatically).

Automation agents: read AGENTS.md first. CLI discovery: qkagent help --json; workflow guide: qkagent guide get --topic workflow --json. Human-readable: docs/cli-commands.md. Cursor skills: .cursor/skills/quicker-agent-exe/SKILL.md, .cursor/skills/qkagent-publish-exe/SKILL.md.

Requirements

• .NET 8 SDK for dotnet run / dotnet build QuickerAgent.slnx (SLNX needs a recent SDK, e.g. 9.0.200+).
• Windows x64 for publish/publish-agent.ps1.
• Google Chrome or Microsoft Edge recommended (used first). Playwright Chromium is installed as fallback when you run the publish script.

Configuration

1. Copy env.example to .env next to qkagent.exe or repo root (loader walks up a few parent directories).

Variable	Description
QUICKER_EMAIL	getquicker.net account (must own the shared action to see the editor).
QUICKER_PASSWORD	Account password.
QKAGENT_HEADLESS	Optional: 1 / true to run without a window (default: headed).
QKAGENT_PROFILE_DIR	Optional: persistent browser profile path (cookies). Default: %LOCALAPPDATA%\qkagent\browser-profile.
QKAGENT_BROWSER_CHANNEL	Optional: force chrome, msedge, or chromium. Default: try Chrome → Edge → Chromium.
QKAGENT_ACTIONS_ROOT	Optional: root for pull/push local files. Default: <repo>/actions when present, else %USERPROFILE%\.quicker\actions.

Page UI labels (编辑信息、源代码、更新动作信息) are fixed in QuickerAgent.Core/GetQuickerActionDocPage.cs.

Do not commit .env.

Usage

pull / push（本仓库 actions/）

动作说明在 actions/<sharedId>/page.html 编写（git）。push 构建 info.html 并上传。

# 1. 编辑 actions/<sharedId>/page.html
# 2. （可选）构建
.\scripts\build-action-docs.ps1 -Id "<shared-guid>"
# 3. 发布
qkagent push --code "<shared-guid>" --json

pull 仅当该动作尚无 page.html、需从线上导入时使用。

See actions/README.md for HTML class reference. Agent skill: .cursor/skills/action-doc-workflow/SKILL.md.

Low-level commands

.\qkagent.exe action-doc get --code "<shared-guid>" --out .\intro.html --json
.\qkagent.exe action-doc get --dir .\samples\action-doc --json
.\qkagent.exe action-doc upload --code "<shared-guid>" --html .\intro.html --json
.\qkagent.exe action-doc set --dir .\samples\action-doc --json

Exit codes

Code	Meaning
0	Success
1	Error (missing credentials, bad paths, login failure, editor/save not found, etc.)

Action folder layout

File	Purpose
action.yaml (or meta.yaml / manifest.yaml)	sharedId or code; optional html path (default description.html).
description.html	HTML for the intro (get writes here; upload reads from here).

Example: samples/action-doc/.

Publish

.\publish\publish-agent.ps1

Output: publish\agent\qkagent.exe and dependencies. The script may append publish\agent to the user PATH.

Repository

Upstream: https://github.com/QuickerHub/quicker-agent