x-cmd-logo X-CMD
微信公众号
oh my x

扫码关注官方微信公众号获取开源软件和 x-cmd 的最新用法与独家资讯

x agent ​

集成 x-cmd 到 Claude、Codex、Cursor、Opencode、Kimi 等 AI 工具，管理 ~/AGENTS.md 及配置文件

TIP

除了使用 x agent setup，還可以手動引入如下提示詞到你的 AGENT 文件中。

Load x-cmd with . ~/.x-cmd.root/X (required before using x), then x -h for help. Docs: https://x-cmd.com/llms.txt Harness: AI 工具接口（kimi-cli、claude、codex、cursor、gemini-cli、opencode）

Agent 000/001: 兩個獨立的 AI Agent 配置身份

例子 ​

示例: 配置 AI 工具使用 x-cmd

sh
x agent setup

示例: 合併各 AI 工具配置文件

sh
x agent unify

示例: 交互式選擇 AI 工具

sh
x agent init

示例: 臨時設置（僅當前會話）

sh
x agent --cur set zero_harness=kimi-cli

示例: 發送單次 AI 請求（解釋這段代碼），直接獲得回覆

sh
x agent request "Explain this code"

示例: 後台異步執行耗時任務，結果保存到文件

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

示例: 創建新任務（添加單元測試並配置 CI），AI 通過對話澄清需求後生成 TODO.md

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

子命令 ​

名称描述
x agent request非交互式單次調用 AI Agent，發送提示詞並獲取響應
x agent job管理長期交互式任務（創建、迭代執行、需求調整）
x agent setup讓主流 AI 工具使用 x-cmd 提示詞和技能
x agent unify合併各 AI 工具配置文件到 ~/AGENTS.md 並創建 symlink
x agent --cfg持久化配置（保存到配置文件，跨會話生效）
x agent --cur臨時配置（僅當前 shell 會話生效）
x agent init交互式初始化配置（選擇並設置 zero_harness、one_harness）

x agent setup ​

讓主流 AI 工具使用 x-cmd 提示詞和技能

INFO

  1. 創建 ~/AGENTS.md（如果不存在）
  2. 安裝 x-cmd skills 到 ~/.agents、~/.claude、~/.codex、~/.gemini、~/.config/opencode
  • 使用:
sh
x agent setup

x agent unify ​

合併各 AI 工具配置文件到 ~/AGENTS.md 並創建 symlink

INFO

處理各 AI 工具配置文件：

  1. 將 ~/CLAUDE.md、~/.gemini/GEMINI.md、~/.codex/AGENTS.md、

    ~/.config/opencode/AGENTS.md 的內容合併到 ~/AGENTS.md

  2. 刪除原文件，創建指向 ~/AGENTS.md 的 symlink

  3. 內容相同的文件直接替換為 symlink，無需合併

  • 使用:
sh
x agent unify

x agent request ​

非交互式單次調用 AI Agent，發送提示詞並獲取響應

  • 例子:

示例: 發送單次 AI 請求（解釋這段代碼），直接獲得回覆

sh
x agent request "Explain this code"

示例: 指定 AI 工具並附加文件後發送請求

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

示例: 附加多個文件，讓 AI 進行對比分析

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

示例: 發送請求並將 AI 回覆保存到文件

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

示例: 以 JSON 格式獲取結構化輸出

sh
x agent request --json "List all functions"
  • 使用:
sh
x agent request [OPTIONS] [FLAGS] <#n>
  • 参数:
参数描述
#n提示詞內容
  • 选项:
名称, 名称简写默认值描述
--harness指定 AI 工具接口
-f, --file附加到提示詞的文件
-o, --output輸出文件路徑
--session指定會話 ID 以恢復之前的對話（UUID 格式）
--workspace指定工作目錄，啓用記憶文件和狀態管理
  • 指令:
名称, 名称简写描述
--overwrite強制覆蓋已存在的輸出文件（不備份，與 --output 配合使用）
--json以 JSON 格式輸出
--pipe從標準輸入讀取內容附加到提示詞

x agent --cfg ​

持久化配置（保存到配置文件，跨會話生效）

INFO

zero_harness: Agent 000 默認 AI 工具

one_harness: Agent 001 默認 AI 工具

可選: kimi-cli, claude, codex, cursor, gemini-cli, opencode

  • 例子:

示例: 同時設置兩個 Agent 的默認 harness

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

示例: 查看當前保存的配置

sh
x agent --cfg cat

示例: 清除所有配置恢復默認

sh
x agent --cfg clear
  • 使用:
sh
x agent --cfg [SUB_COMMAND] <#n>
  • 参数:
参数描述
#nzero_harness= | one_harness=
  • 子命令:
名称描述
x agent --cfg clear清除所有已保存的配置（恢復默認值）
x agent --cfg cat顯示當前配置值

x agent --cfg clear ​

清除所有已保存的配置（恢復默認值）

  • 使用:
sh
x agent --cfg clear

x agent --cfg cat ​

顯示當前配置值

  • 使用:
sh
x agent --cfg cat

x agent --cur ​

臨時配置（僅當前 shell 會話生效）

INFO

zero_harness: Agent 000 臨時 AI 工具

one_harness: Agent 001 臨時 AI 工具

僅覆蓋當前會話的 --cfg 配置

  • 子命令:
名称描述
x agent --cur set設置臨時配置值

x agent --cur set ​

設置臨時配置值

  • 使用:
sh
x agent --cur set [SUB_COMMAND] <#n>
  • 参数:
参数描述
#nzero_harness= | one_harness=
  • 子命令:
名称描述
x agent --cur set zero_harness=Agent 000 臨時 harness
x agent --cur set one_harness=Agent 001 臨時 harness

x agent --cur set zero_harness= ​

Agent 000 臨時 harness

  • 使用:
sh
x agent --cur set zero_harness=

x agent --cur set one_harness= ​

Agent 001 臨時 harness

  • 使用:
sh
x agent --cur set one_harness=

x agent init ​

交互式初始化配置（選擇並設置 zero_harness、one_harness）

  • 使用:
sh
x agent init

x agent job ​

管理長期交互式任務（創建、迭代執行、需求調整）

  • 例子:

示例: 創建新任務（添加單元測試並配置 CI），AI 通過對話澄清需求後生成 TODO.md

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

示例: 繼續執行最近任務，AI 自動按 TODO 迭代推進

sh
x agent job iter

示例: 調整最近任務的需求（增加更多測試用例），AI 更新 TODO.md

sh
x agent job adjust "Add more test cases"

示例: 列出所有任務

sh
x agent job ls
  • 子命令:
名称描述
x agent job init創建新的長期任務，AI 通過交互式對話澄清需求並生成 TODO.md
x agent job iter迭代執行任務，AI 自動循環執行 TODO 直到完成或達到最大迭代次數
x agent job adjust調整任務需求，AI 通過交互式對話更新 TODO.md
x agent job ls列出所有任務

x agent job init ​

創建新的長期任務，AI 通過交互式對話澄清需求並生成 TODO.md

  • 例子:

示例: 創建新任務（添加單元測試並配置 CI），AI 通過對話澄清需求後生成 TODO.md

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

示例: 創建複雜功能開發（實現 OAuth2 多提供商登錄），拆分為多個子任務

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

示例: 在指定父目錄創建任務（修復內存泄漏）

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

示例: 使用指定 AI 工具創建設計類任務（設計帶自動補全的 Docker CLI 工具）

sh
x agent job init --harness claude "Design a CLI tool for managing Docker containers with autocomplete support"
  • 使用:
sh
x agent job init [OPTIONS] <#1>
  • 参数:
参数描述
#1任務描述
  • 选项:
名称, 名称简写默认值描述
--harness指定 AI 工具接口
--dir指定任務父目錄路徑（任務將創建在此目錄下）

x agent job iter ​

迭代執行任務，AI 自動循環執行 TODO 直到完成或達到最大迭代次數

  • 例子:

示例: 繼續執行最近任務，AI 自動按 TODO 迭代推進

sh
x agent job iter

示例: 繼續執行指定目錄的最新任務

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

示例: 繼續執行指定 ID 的任務

sh
x agent job iter --id 260413_112030

示例: 繼續執行指定目錄下指定 ID 的任務

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

示例: 限制最大迭代次數和連續無修改閾值後繼續執行任務

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

示例: 啓用連續會話模式，所有迭代共享同一個 session ID，保留歷史上下文

sh
x agent job iter --continuous
  • 使用:
sh
x agent job iter [OPTIONS] [FLAGS]
  • 选项:
名称, 名称简写默认值描述
--harness指定 AI 工具接口
--dir指定任務父目錄路徑
-i, --id指定任務 ID（與 --dir 配合使用，也可單獨使用）
--max-iterations最大迭代次數（默認 100）
--inrow連續無修改即完成的閾值（默認 2）
  • 指令:
名称, 名称简写描述
--continuous連續會話模式，所有迭代共享同一個 session ID，保留歷史上下文

x agent job adjust ​

調整任務需求，AI 通過交互式對話更新 TODO.md

  • 例子:

示例: 調整最近任務的需求（為認證模組添加錯誤處理），AI 更新 TODO.md

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

示例: 調整指定 ID 任務的需求

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

示例: 調整指定目錄下指定 ID 任務的需求

sh
x agent job adjust --dir ~/tasks/myjob --id 260413_112030 "Change the API endpoint"
  • 使用:
sh
x agent job adjust [OPTIONS] <#1>
  • 参数:
参数描述
#1新的需求描述或調整説明
  • 选项:
名称, 名称简写默认值描述
--harness指定 AI 工具接口
--dir指定任務父目錄路徑
-i, --id指定任務 ID（與 --dir 配合使用，也可單獨使用）

x agent job ls ​

列出所有任務

  • 例子:

示例: 列出所有任務（終端下進入交互選擇，非終端下輸出 TSV）

sh
x agent job ls

示例: 只顯示活躍任務（有 TODO.md）

sh
x agent job ls --active

示例: 只顯示已完成任務（有 DONE.md）

sh
x agent job ls --completed

示例: CSV 格式輸出

sh
x agent job ls --csv

示例: 活躍任務以 TSV 格式輸出

sh
x agent job ls --active --tsv

示例: 強制進入交互式應用模式，選擇任務後可預覽/繼續/調整/刪除

sh
x agent job ls --app
  • 使用:
sh
x agent job ls [OPTIONS] [FLAGS]
  • 选项:
名称, 名称简写默认值描述
--dir指定任務父目錄路徑
  • 指令:
名称, 名称简写描述
--active只顯示活躍的任務（有 TODO.md）
--completed只顯示已完成的任務（有 DONE.md）
--csv以 CSV 格式輸出
--tsv以 TSV 格式輸出（標準輸出不是終端時的默認格式）
--app啓動交互式應用，可選擇任務並預覽、繼續執行、調整或刪除

TIP

在交互式终端中（如 zsh, bash ...），可以使用 Tab 获取补全信息

运行 CMD SUBCOMMAND --help 可以获取命令的更多信息

本文作者

李均豪
李均豪
X-CMD 創始人 & CEO
• https://ljh.sh

轉載請註明本文出處及鏈接

https://hk.x-cmd.com/mod/agent

幫助我們改善文檔

X-CMD 的文檔內容來自命令的幫助文檔、多個數據源以及文檔庫生成。文檔中如果有錯誤或不明確的地方，歡迎通過這些方式進行告知~