Qwen Code CLI Guide

craft-agent is the preferred interface for managing workspace config domains such as labels, sources, skills, and automations.

Usage

bash

craft-agent <entity> <action> [args] [--flags] [--json '<json>'] [--stdin]

Global flags

craft-agent --help
craft-agent --version
craft-agent --discover

Input modes

Flat flags for simple values
--json for structured inputs
--stdin for piped JSON object input

Label

Manage workspace labels stored under labels/.

Commands

craft-agent label list
craft-agent label get <id>
craft-agent label create --name "<name>" [--color "<color>"] [--parent-id <id|root>] [--value-type string|number|date]
craft-agent label update <id> [--name "<name>"] [--color "<color>"] [--value-type string|number|date|none] [--clear-value-type]
craft-agent label delete <id>
craft-agent label move <id> --parent <id|root>
craft-agent label reorder [--parent <id|root>] <ordered-id-1> <ordered-id-2> ...
craft-agent label auto-rule-list <id>
craft-agent label auto-rule-add <id> --pattern "<regex>" [--flags "gi"] [--value-template "$1"] [--description "..."]
craft-agent label auto-rule-remove <id> --index <n>
craft-agent label auto-rule-clear <id>
craft-agent label auto-rule-validate <id>

Examples

bash

craft-agent label list
craft-agent label get bug
craft-agent label create --name "Bug" --color "accent"
craft-agent label create --name "Priority" --value-type number
craft-agent label update bug --json '{"name":"Bug Report","color":"destructive"}'
craft-agent label update priority --value-type none
craft-agent label move bug --parent root
craft-agent label reorder --parent root development content bug
craft-agent label auto-rule-add linear-issue --pattern "\\b([A-Z]{2,5}-\\d+)\\b" --value-template "$1"
craft-agent label auto-rule-list linear-issue
craft-agent label auto-rule-validate linear-issue

Notes

Use --json / --stdin for nested or bulk updates.
IDs are stable slugs generated from name on create.
Use --value-type none or --clear-value-type to remove a label value type.

Source

Manage workspace sources stored under sources/{slug}/.

Commands

craft-agent source list [--include-builtins true|false]
craft-agent source get <slug>
craft-agent source create (see flags below)
craft-agent source update <slug> --json '{...}'
craft-agent source delete <slug>
craft-agent source validate <slug>
craft-agent source test <slug>
craft-agent source init-guide <slug> [--template generic|mcp|api|local]
craft-agent source init-permissions <slug> [--mode read-only]
craft-agent source auth-help <slug>

Flags for `source create`

Flag	Description
`--name "<name>"`	(required) Source display name
`--provider "<provider>"`	(required) Provider identifier (e.g., `linear`, `github`)
`--type mcp\|api\|local`	(required) Source type
`--enabled true\|false`	Enable/disable source (default: `true`)
`--icon "<url-or-emoji>"`	Icon URL (auto-downloaded) or emoji
MCP-specific
`--url "<url>"`	MCP server URL
`--transport http\|stdio`	MCP transport type
`--auth-type oauth\|bearer\|none`	MCP authentication type
API-specific
`--base-url "<url>"`	(required for api) API base URL (must have trailing slash)
`--auth-type bearer\|header\|query\|basic\|none`	(required for api) API auth type
Local-specific
`--path "<path>"`	(required for local) Filesystem path

Examples

bash

craft-agent source list
craft-agent source get linear
# MCP source with flat flags
craft-agent source create --name "Linear" --provider "linear" --type mcp --url "https://mcp.linear.app/sse" --auth-type oauth
# MCP source with --json for nested config
craft-agent source create --name "Linear" --provider "linear" --type mcp --json '{"mcp":{"transport":"http","url":"https://mcp.linear.app/sse","authType":"oauth"}}'
# API source
craft-agent source create --name "Exa" --provider "exa" --type api --base-url "https://api.exa.ai/" --auth-type header
# Local source
craft-agent source create --name "Docs Folder" --provider "filesystem" --type local --path "~/Documents"
craft-agent source update linear --json '{"enabled":false}'
craft-agent source validate linear
craft-agent source test linear
craft-agent source init-guide linear --template mcp
craft-agent source init-permissions linear --mode read-only
craft-agent source auth-help linear

Notes

Use flat flags for simple values or --json for type-specific nested config fields (mcp, api, local).
init-guide scaffolds a practical guide.md based on source type.
init-permissions scaffolds read-only permissions.json patterns for Explore mode.
auth-help returns the recommended in-session auth tool and mode.
test is lightweight CLI validation; for full in-session auth/connection probing use source_test MCP tool.

Skill

Manage workspace skills stored under skills/{slug}/SKILL.md.

Commands

craft-agent skill list [--workspace-only] [--project-root <path>]
craft-agent skill get <slug> [--project-root <path>]
craft-agent skill where <slug> [--project-root <path>]
craft-agent skill create (see flags below)
craft-agent skill update <slug> --json '{...}' [--project-root <path>]
craft-agent skill delete <slug>
craft-agent skill validate <slug> [--source workspace|project|global] [--project-root <path>]

Flags for `skill create`

Flag	Description
`--name "<name>"`	(required) Skill display name
`--description "<desc>"`	(required) Brief description (1-2 sentences)
`--slug "<slug>"`	Custom slug (auto-generated from name if omitted)
`--body "..."`	Skill content/instructions (markdown body)
`--icon "<url>"`	Icon URL (auto-downloaded to `icon.*`)
`--globs ".ts,.tsx"`	Comma-separated glob patterns for auto-suggestion
`--always-allow "Bash,Write"`	Comma-separated tool names to always allow
`--required-sources "linear,github"`	Comma-separated source slugs to auto-enable

Examples

bash

craft-agent skill list
craft-agent skill list --workspace-only
craft-agent skill where commit-helper
craft-agent skill create --name "Commit Helper" --description "Generate conventional commits" --slug commit-helper
craft-agent skill create --name "Code Review" --description "Review PRs" --globs "*.ts,*.tsx" --always-allow "Bash" --required-sources "github"
craft-agent skill update commit-helper --json '{"requiredSources":["github"],"body":"Use concise, imperative commit messages."}'
craft-agent skill validate commit-helper
craft-agent skill validate commit-helper --source global
craft-agent skill delete commit-helper

Notes

create / update write SKILL.md frontmatter and content body.
Use where to inspect project/workspace/global resolution precedence.
--project-root scopes resolution to a project directory (defaults to cwd).

Automation

Manage workspace automations stored in automations.json.

Commands

craft-agent automation list
craft-agent automation get <id>
craft-agent automation create (see flags below)
craft-agent automation update <id> (same flags as create, all optional)
craft-agent automation delete <id>
craft-agent automation enable <id>
craft-agent automation disable <id>
craft-agent automation duplicate <id>
craft-agent automation history [<id>] [--limit <n>]
craft-agent automation last-executed <id>
craft-agent automation test <id> [--match "..."]
craft-agent automation lint
craft-agent automation validate

Flags for `automation create` / `update`

Flag	Description
`--event <EventName>`	(required for create) Event trigger (e.g., `UserPromptSubmit`, `SchedulerTick`, `LabelAdd`)
`--name "<name>"`	Display name for the automation
`--matcher "<regex>"`	Regex pattern for event matching
`--cron "<expression>"`	Cron expression (for `SchedulerTick` events)
`--timezone "<tz>"`	IANA timezone (e.g., `Europe/Budapest`)
`--permission-mode safe\|ask\|allow-all`	Permission level for created sessions
`--enabled true\|false`	Enable/disable the automation
`--labels "label1,label2"`	Comma-separated labels for created sessions
`--prompt "..."`	Prompt text (creates a prompt action automatically)
`--llm-connection "<slug>"`	LLM connection slug for the created session
`--model "<model-id>"`	Model ID for the created session

Examples

bash

craft-agent automation list
craft-agent automation validate
# Simple prompt automation with flat flags
craft-agent automation create --event UserPromptSubmit --prompt "Summarize this prompt"
# Scheduled automation with flat flags
craft-agent automation create --event SchedulerTick --cron "0 9 * * 1-5" --timezone "Europe/Budapest" --prompt "Give me a morning briefing" --labels "Scheduled" --permission-mode safe
# Complex automation with --json
craft-agent automation create --event SchedulerTick --json '{"cron":"0 9 * * 1-5","actions":[{"type":"prompt","prompt":"Daily summary"}]}'
craft-agent automation update abc123 --name "Morning Report" --prompt "Updated prompt"
craft-agent automation update abc123 --enabled false
craft-agent automation enable abc123
craft-agent automation duplicate abc123
craft-agent automation history abc123 --limit 10
craft-agent automation last-executed abc123
craft-agent automation test abc123 --match "UserPromptSubmit"
craft-agent automation lint
craft-agent automation delete abc123

Notes

Use flat flags for simple automations or --json for complex matchers with multiple actions.
--prompt is a shortcut that auto-wraps the text as a prompt action. Use --json with actions for multi-action automations.
lint provides quick matcher/action hygiene checks (regex validity, missing actions, oversized prompt mention sets).
history and last-executed read from automations-history.jsonl when present.
validate runs full schema and semantic checks.

Permission

Manage Explore mode permissions stored in permissions.json (workspace-level and per-source).

Commands

craft-agent permission list
craft-agent permission get [--source <slug>]
craft-agent permission set [--source <slug>] --json '{...}'
craft-agent permission add-mcp-pattern "<pattern>" [--comment "..."] [--source <slug>]
craft-agent permission add-api-endpoint --method GET|POST|... --path "<regex>" [--comment "..."] [--source <slug>]
craft-agent permission add-bash-pattern "<pattern>" [--comment "..."] [--source <slug>]
craft-agent permission add-write-path "<glob>" [--source <slug>]
craft-agent permission remove <index> --type mcp|api|bash|write-path|blocked [--source <slug>]
craft-agent permission validate [--source <slug>]
craft-agent permission reset [--source <slug>]

Scope

Without --source: operates on workspace-level permissions.json (global rules). With --source <slug>: operates on that source's permissions.json (auto-scoped).

Examples

bash

# List all permissions files (workspace + sources)
craft-agent permission list
# Get workspace permissions
craft-agent permission get
# Get source-specific permissions
craft-agent permission get --source linear
# Add read-only MCP patterns for a source
craft-agent permission add-mcp-pattern "list" --comment "List operations" --source linear
craft-agent permission add-mcp-pattern "get" --comment "Get operations" --source linear
craft-agent permission add-mcp-pattern "search" --comment "Search operations" --source linear
# Add API endpoint rules
craft-agent permission add-api-endpoint --method GET --path ".*" --comment "All GET requests" --source stripe
# Add bash patterns
craft-agent permission add-bash-pattern "^ls\\s" --comment "Allow ls"
# Add write path globs
craft-agent permission add-write-path "/tmp/**"
# Remove a rule by index and type
craft-agent permission remove 1 --type mcp --source linear
# Replace entire config
craft-agent permission set --source github --json '{"allowedMcpPatterns":[{"pattern":"list","comment":"List ops"}]}'
# Validate all permissions
craft-agent permission validate
# Validate source-specific
craft-agent permission validate --source linear
# Delete permissions file (revert to defaults)
craft-agent permission reset --source linear

Notes

Source-level MCP patterns are auto-scoped at runtime (e.g., list becomes mcp__<slug>__.*list).
remove uses 0-based index within the specified rule type array. Use get to see indices.
validate runs schema + regex validation. Without --source, validates workspace + all sources.
reset deletes the permissions file, reverting to defaults.

Theme

Manage app-level and workspace-level theme settings.

Commands

craft-agent theme get
craft-agent theme validate [--preset <id>]
craft-agent theme list-presets
craft-agent theme get-preset <id>
craft-agent theme set-color-theme <id>
craft-agent theme set-workspace-color-theme <id|default>
craft-agent theme set-override --json '{...}'
craft-agent theme reset-override

Examples

bash

# Inspect current theme state
craft-agent theme get

# Validate app override file
craft-agent theme validate

# Validate one preset file
craft-agent theme validate --preset nord

# List available presets
craft-agent theme list-presets

# Inspect a specific preset
craft-agent theme get-preset dracula

# Set app default preset
craft-agent theme set-color-theme nord

# Set workspace override
craft-agent theme set-workspace-color-theme dracula

# Clear workspace override (inherit app default)
craft-agent theme set-workspace-color-theme default

# Replace app-level theme.json override
craft-agent theme set-override --json '{"accent":"oklch(0.62 0.21 293)","dark":{"accent":"oklch(0.68 0.21 293)"}}'

# Remove app-level override file
craft-agent theme reset-override

Notes

set-color-theme and set-workspace-color-theme require an existing preset ID (default is always valid).
set-override validates theme.json shape before writing.
Workspace override is stored in workspace/config.json under defaults.colorTheme.
App override is stored in ~/.craft-agent/theme.json.

Output contract

All commands return a single JSON envelope on stdout.

Success

json

{ "ok": true, "data": {}, "warnings": [] }

Error

json

{
  "ok": false,
  "error": {
    "code": "USAGE_ERROR",
    "message": "...",
    "suggestion": "..."
  },
  "warnings": []
}

Exit codes:

0 success
1 execution/internal failure
2 usage/validation/input failure

Qwen Code CLI Guide

Qwen Code CLI Guide

Usage

Global flags

Input modes

Label

Commands

Examples

Notes

Source

Commands

Flags for source create

Examples

Notes

Skill

Commands

Flags for skill create

Examples

Notes

Automation

Commands

Flags for automation create / update

Examples

Notes

Permission

Commands

Scope

Examples

Notes

Theme

Commands

Examples

Notes

Output contract

Success

Error

Flags for `source create`

Flags for `skill create`

Flags for `automation create` / `update`