105 lines
3.1 KiB
JSON
105 lines
3.1 KiB
JSON
{
|
|
"name": "agent",
|
|
"section": 1,
|
|
"title": "Bare OS coding agent",
|
|
"synopsis": [
|
|
"agent [OPTION]... REQUEST...",
|
|
"agent --setup",
|
|
"agent --status",
|
|
"agent --plan REQUEST...",
|
|
"agent --auto GOAL...",
|
|
"agent skills | todos | plan | compact | reset | undo | hooks | history | rewind | export | remember | recap"
|
|
],
|
|
"description": "Runs the in-guest ReAct coding agent. Default backend is QVAC (local ctx.bareOsQvac*); REST (OpenAI-compatible) is optional. Full guest admin by default (denylist): the read-only base system is /bin /etc /boot /lib /usr /share /proc /dev /sys /run. Tools include grep (output_mode), apply_patch, web_search, git helpers, find_symbol, copy_path, diff_files, create_skill, session rewind/export, todos, plan mode, and walk-up project skills. History lives in ~/.agent/history.json and is shared with Discord /agent. Inspect subcommands (skills, todos, plan, undo, hooks, history, rewind, export, remember, recap) do not call the model.",
|
|
"options": [
|
|
{
|
|
"flag": "--setup, --config",
|
|
"meaning": "Interactive QVAC or REST setup; only the chosen backend is stored"
|
|
},
|
|
{
|
|
"flag": "--auto, --autonomous",
|
|
"meaning": "Keep the tool loop running until task_complete, stop, or timebox"
|
|
},
|
|
{
|
|
"flag": "--plan",
|
|
"meaning": "Start in plan mode (read-only except ~/.agent/plan.md)"
|
|
},
|
|
{
|
|
"flag": "--new, --reset",
|
|
"meaning": "Clear chat history; with a request, start a fresh session then run"
|
|
},
|
|
{
|
|
"flag": "--continue, -c",
|
|
"meaning": "Resume ~/.agent/history.json (default)"
|
|
},
|
|
{
|
|
"flag": "--compact",
|
|
"meaning": "Compact history now; with a request, compact then run"
|
|
},
|
|
{
|
|
"flag": "--max-turns N",
|
|
"meaning": "Cap ReAct iterations for this run"
|
|
},
|
|
{
|
|
"flag": "--model NAME",
|
|
"meaning": "Override QVAC or REST model for this run"
|
|
},
|
|
{
|
|
"flag": "--system FILE",
|
|
"meaning": "Append extra instructions from an absolute guest path"
|
|
},
|
|
{
|
|
"flag": "--status",
|
|
"meaning": "Print backend, compaction, plan mode, and autonomous state"
|
|
},
|
|
{
|
|
"flag": "-h, --help",
|
|
"meaning": "Show usage"
|
|
}
|
|
],
|
|
"keywords": [
|
|
"agent",
|
|
"qvac",
|
|
"llm",
|
|
"coding",
|
|
"bare-os",
|
|
"coreutils"
|
|
],
|
|
"seeAlso": [
|
|
{
|
|
"name": "discord-bot",
|
|
"section": 1
|
|
}
|
|
],
|
|
"examples": [
|
|
{
|
|
"caption": "one-shot request",
|
|
"code": "agent \"summarize ~/README and list /bin\""
|
|
},
|
|
{
|
|
"caption": "plan first",
|
|
"code": "agent --plan \"design a /bin/foo utility\""
|
|
},
|
|
{
|
|
"caption": "autonomous run",
|
|
"code": "agent --auto --max-turns 40 \"add agent tests and run them\""
|
|
},
|
|
{
|
|
"caption": "inspect skills",
|
|
"code": "agent skills"
|
|
},
|
|
{
|
|
"caption": "rewind last user turn",
|
|
"code": "agent rewind"
|
|
},
|
|
{
|
|
"caption": "remember a durable fact",
|
|
"code": "agent remember \"holesail keys live in ~/.holesail\""
|
|
},
|
|
{
|
|
"caption": "export transcript",
|
|
"code": "agent export ~/.agent/export.md"
|
|
}
|
|
]
|
|
}
|