The Archive · CLI · Guides
Add MCP servers, hooks and commands
Prepare a project, trust it, add an MCP server, a hook, a plugin or a command of your own, and test each before it runs.
Checked on CLI 0.3.3
A newer version is out (CLI 0.5.2): some details may differ.
Why each extension waits for your trust is explained in Extensions.
Prepare and trust the project
Section titled “Prepare and trust the project”talos init # creates .talos-cli/ with commands/, extensions/ and an empty config.jsontalos project status # what is trusted, why, and the project files that can run codetalos project trust # trusts the project and the current snapshot of its executable filestalos project revoke removes the trust: the project’s hooks, MCP servers, plugins and commands stop loading.
An MCP server
Section titled “An MCP server”talos mcp list # the servers, with their source, trust and statetalos mcp test <id> # starts it and checks protocol, tools, trust, permissions and recent logstalos mcp trust <id>Its tools then go through your permissions like any other — as Mcp(server:operation).
A hook
Section titled “A hook”talos hook listtalos hook dry-run <id> <event> # runs it with a synthetic event, the way a real one wouldtalos hook trust <id>talos hook history <id> # its last runstalos hook quarantine <id> denies a hook until you release it; releasing does not restore its trust.
A plugin
Section titled “A plugin”talos plugin install <source>talos plugin listtalos plugin trust <id>Installing does not make a plugin run: the project’s trust must cover the new package first.
A command of your own
Section titled “A command of your own”A custom command is a Markdown file, for example in .talos-cli/commands/ of the project; its text becomes the prompt,
with {{arg1}}, {{arg2}}… for its arguments. In the interactive screen it is a slash command.
talos command list # commands, skills and workflows, with where they come from and whether they are validtalos command run <name> <arg> # prints the prompt it expands to