Sync an agent's config-plane files with a local directory
Sync an agent's config-plane files between a local directory (typically your git repo) and the running agent.
The syncable set is the config plane only: .agent_instructions.md, project
context files (GENIE.md, CLAUDE.md, AGENTS.md) at the agent root and at each
user-workspace root (users/
Memory, sessions, secrets, tool settings, user workspace content, and runtime state never sync.
Hosted agents sync through the Mutiro API.
For self-hosted agents pass --agent-dir to operate on the local agent directory directly.
Examples:
See what a push would change
mutiro agent files push my-agent ./my-agent-repo --dry-run
Deploy repo files to the agent, labeled with the current git commit
mutiro agent files push my-agent ./my-agent-repo
Bring agent self-edits back into the repo as a working-tree diff
mutiro agent files pull my-agent ./my-agent-repo
Self-hosted: same verbs against the local agent dir
mutiro agent files push my-agent ./my-agent-repo --agent-dir ~/agents/my-agent
See what a push would change
Deploy repo files to the agent, labeled with the current git commit
Bring agent self-edits back into the repo as a working-tree diff
Self-hosted: same verbs against the local agent dir
| Flag | Type | Description |
|---|---|---|
| -h, --help | bool | help for files |
| Flag | Type | Description |
|---|---|---|
| --config | string | config file (default is ./.mutiro.yaml in current directory) |
| --debug | bool | debug mode |
| -v, --verbose | bool | verbose output |
mutiro agent
Agent operations - host, status, send, and profile
mutiro agent files list
Show the agent's syncable files and last deploy marker
mutiro agent files mark
Rewrite the deploy marker without transferring files (like a git tag)
mutiro agent files pull
Download the agent's config-plane files into a local directory
mutiro agent files push
Upload local config-plane files to the agent (one push = one deploy)