x agent ​

Integrate x-cmd into Claude, Codex, Cursor, Opencode, Kimi and other AI tools, manage ~/AGENTS.md and configs

Examples ​

Example: Configure AI tools to use x-cmd

x agent setup

Example: Merge config files from AI tools

x agent unify

Example: Interactively select AI tools

x agent init

Example: Set temporarily (current session only)

x agent --cur set zero_harness=kimi-cli

Example: Send a single-turn AI request (explain this code) and get instant reply

x agent request "Explain this code"

Example: Run long task asynchronously in background, save result to file

x agent requestasync --stdout-file result.md "Long running task"

Example: Create a new task (add unit tests and set up CI), AI clarifies requirements via chat and generates TODO.md

x agent job init "Add unit tests with Jest and set up GitHub Actions CI"

Sub Commands ​

x agent setup ​

Enable mainstream AI tools to use x-cmd prompts and skills

• Usage:

x agent setup

x agent unify ​

Merge AI tool config files into ~/AGENTS.md and create symlinks

• Usage:

x agent unify

x agent request ​

Non-interactive single-shot AI Agent invocation - send prompt and get response

• Examples:

Example: Send a single-turn AI request (explain this code) and get instant reply

x agent request "Explain this code"

Example: Choose a specific AI harness and attach a file before sending

x agent request --harness claude --file main.py "Review this code"

Example: Attach multiple files and ask AI to compare them

x agent request -f file1.py -f file2.py "Compare these files"

Example: Send a request and save the AI reply to a file

x agent request --output result.md "Generate documentation"

Example: Get a structured JSON response

x agent request --json "List all functions"

• Usage:

x agent request [OPTIONS] [FLAGS] <#n>

• Arguments:

• Options:

• Flags:

x agent --cfg ​

Persistent configuration (saved to config file, cross-session)

• Examples:

Example: Set default harness for both Agents

x agent --cfg zero_harness=kimi-cli one_harness=claude

Example: View current saved configuration

x agent --cfg cat

Example: Clear all configuration to defaults

x agent --cfg clear

• Usage:

x agent --cfg [SUB_COMMAND] <#n>

• Arguments:

• Sub Commands:

x agent --cfg clear ​

Clear all saved configuration (restore defaults)

• Usage:

x agent --cfg clear

x agent --cfg cat ​

Display current configuration values

• Usage:

x agent --cfg cat

x agent --cur ​

Temporary configuration (current shell session only)

• Sub Commands:

x agent --cur set ​

Set temporary configuration values

• Usage:

x agent --cur set [SUB_COMMAND] <#n>

• Arguments:

• Sub Commands:

x agent --cur set zero_harness= ​

Temporary harness for Agent 000

• Usage:

x agent --cur set zero_harness=

x agent --cur set one_harness= ​

Temporary harness for Agent 001

• Usage:

x agent --cur set one_harness=

x agent init ​

Interactive initialization (select and set zero_harness, one_harness)

• Usage:

x agent init

x agent job ​

Manage long-term interactive tasks (create, iterate, adjust requirements)

• Examples:

Example: Create a new task (add unit tests and set up CI), AI clarifies requirements via chat and generates TODO.md

x agent job init "Add unit tests with Jest and set up GitHub Actions CI"

Example: Resume the most recent task, AI auto-iterates through TODO

x agent job iter

Example: Adjust the most recent task requirements (add more test cases), AI updates TODO.md

x agent job adjust "Add more test cases"

Example: List all tasks

x agent job ls

• Sub Commands:

x agent job init ​

Create a new long-term task, AI clarifies requirements via interactive chat and generates TODO.md

• Examples:

Example: Create a new task (add unit tests and set up CI), AI clarifies requirements via chat and generates TODO.md

x agent job init "Add unit tests with Jest and set up GitHub Actions CI"

Example: Create a complex feature development (implement OAuth2 multi-provider login), broken into multiple sub-tasks

x agent job init "Implement OAuth2 login with Google and GitHub providers, including token refresh"

Example: Create a task in a specific parent directory (fix memory leak)

x agent job init --dir ~/tasks "Fix memory leak"

Example: Create a design task with a specific AI harness (design a Docker CLI tool with autocomplete)

x agent job init --harness claude "Design a CLI tool for managing Docker containers with autocomplete support"

• Usage:

x agent job init [OPTIONS] <#1>

• Arguments:

• Options:

x agent job iter ​

Iterate task execution, AI auto-loops through TODO until complete or max iterations reached

• Examples:

Example: Resume the most recent task, AI auto-iterates through TODO

x agent job iter

Example: Resume the most recent task in a specific directory

x agent job iter --dir ~/tasks/myjob

Example: Resume task with specific ID

x agent job iter --id 260413_112030

Example: Resume specific task in specific directory

x agent job iter --dir ~/tasks/myjob --id 260413_112030

Example: Resume task with limited max iterations and no-change threshold

x agent job iter --max-iterations 50 --inrow 3

Example: Enable continuous session mode, all iterations share the same session ID with preserved context

x agent job iter --continuous

• Usage:

x agent job iter [OPTIONS] [FLAGS]

• Options:

• Flags:

x agent job adjust ​

Adjust task requirements, AI updates TODO.md via interactive chat

• Examples:

Example: Adjust the most recent task requirements (add error handling to the auth module), AI updates TODO.md

x agent job adjust "Add error handling to the auth module"

Example: Adjust requirements for a specific job ID

x agent job adjust --id 260413_112030 "Add error handling to the auth module"

Example: Adjust requirements for specific task in specific directory

x agent job adjust --dir ~/tasks/myjob --id 260413_112030 "Change the API endpoint"

• Usage:

x agent job adjust [OPTIONS] <#1>

• Arguments:

• Options:

x agent job ls ​

List all tasks

• Examples:

Example: List all tasks (interactive app in terminal, TSV otherwise)

x agent job ls

Example: Show only active tasks (with TODO.md)

x agent job ls --active

Example: Show only completed tasks (with DONE.md)

x agent job ls --completed

Example: Output in CSV format

x agent job ls --csv

Example: Show active tasks in TSV format

x agent job ls --active --tsv

Example: Force interactive app mode to select, preview, iterate, adjust, or delete tasks

x agent job ls --app

• Usage:

x agent job ls [OPTIONS] [FLAGS]

• Options:

• Flags: