CLI reference

Running talos

talos [prompt…]

Opens the interactive screen in the current folder; a prompt, if given, is the first message.

talos setup

Opens the guided setup: provider, key and model.

talos -p <prompt> [--json | --output-format stream-json]

Runs one task without the interactive screen (headless) and prints the answer, a JSON result, or a stream of JSON events.

talos --resume <id|last> [-p <prompt>]

Continues a session; last is the most recent one.

talos --fork <id> [-p <prompt>]

Starts a new session from a copy of an existing one.

talos <family> <operation> [arguments] [options]

Runs a subcommand: see the families below.

• Headless: when no prompt is given and the standard input is not a terminal, the prompt is read from the standard input.
• A headless run stops after 180 seconds unless --timeout says otherwise.
• In headless runs nothing can be asked: an action that needs approval is denied, and the run says so.

Command families · 22

• talos project Whether TALOS trusts the project folder, and the files in it that can run code. 5
• talos config Reads and writes settings in the user, project and project-user scopes; simulates a permission decision. 9
• talos provider The model providers: keys, sign-in, endpoints and health. 7
• talos model Lists models, picks the model TALOS uses and its reasoning effort. 3
• talos session Lists, finds, labels, resumes, forks, shares, exports, imports and deletes sessions. 15
• talos mcp The MCP servers TALOS can use: list, trust, untrust, test. 4
• talos hook Commands that run on session events: list, trust, test with a synthetic event, history, quarantine. 8
• talos plugin Extension packages: install, remove, list, trust, quarantine. 8
• talos command Your own commands, skills and workflows written in Markdown: list, show, expand. 3
• talos memory What TALOS remembers across sessions: list, search, add, update, delete. 5
• talos notes Your notes: list, add, update, delete, link to sessions, tasks and research. 6
• talos tasks The task board: add, update, complete, dependencies, evidence, agents, schedules. 13
• talos library Your documents: import, search, read, export, find duplicates, reference them in a conversation. 10
• talos research Research that reads, verifies and keeps its sources: start, list, read, export, pause, resume, cancel. 9
• talos automation Tasks that run by themselves: add, schedule daily, run now, history, and the Windows runner. 13
• talos forge Tools created by TALOS during a session: inspect, validate, scan, simulate, install, versions, rollback. 10
• talos checkpoint The file checkpoints TALOS takes before it changes files: list, show, undo, redo. 4
• talos doctor Says what is ready and what is missing: runtime, folders, providers, credentials, catalog. —
• talos logs Prints the last lines of the TALOS logs. —
• talos diagnostic A ZIP to attach to a bug report: doctor, configuration and logs, with secrets removed and paths replaced. —
• talos update Checks for a newer version of the CLI. —
• talos init Prepares the project folder for TALOS. —

More reference

• Global optionsThe options of talos itself.
• PermissionsModes, rules and the order of a decision.
• ConfigurationEvery setting, its type, default and scopes.
• Environment variablesWhat TALOS reads from the environment.
• ProvidersEvery provider: protocol, key variables, endpoint.
• Slash commandsThe / commands of the interactive screen.
• Key bindingsEvery key of the interactive screen.
• Exit codes and errorsWhat a script can rely on.
• Files and foldersWhere TALOS keeps settings, sessions and logs.