deepchat-cli

1# DeepChat CLI
2 
3Use the bundled `deepchat` command to ask the running DeepChat main process to perform supported
4operations. The main process remains the sole owner of providers, credentials, Skills, MCP servers,
5artifacts, Agent runs, and approvals.
6 
7## Command rules
8 
9- Every command must begin exactly with `deepchat <domain> <verb>`. Put `--json`, `--jsonl`,
10  `--timeout`, and all domain options after the domain and verb.
11- Execute one standalone command per `exec` call. Do not use pipes, redirection, command separators,
12  command substitution, environment assignments, or shell wrappers around `deepchat`.
13- Quote every user-controlled argument for the current shell. Never interpolate untrusted text into
14  an unquoted command.
15- Prefer `--json` for one result and `--jsonl` for streaming or benchmark collection. Use text mode
16  only when its output will be returned directly to the user.
17- Do not inspect authentication environment variables or DeepChat's local descriptor. Authorization
18  is injected only after the command has passed the normal shell permission check.
19- A shell approval authorizes command execution. Sensitive mutations can additionally pause for a
20  renderer approval; wait for that decision and never attempt to manufacture confirmation data.
21- Use `deepchat help` or `deepchat <domain> <verb> --help` only when the options below are
22  insufficient. Do not probe undocumented routes.
23 
24## Agent file and recursion boundaries
25…