Reference
CLI commands
Every Mallard subcommand — install, update, doctor, registry, version.
The binary auto-detects installed agents (claude, codex, opencode) and
symlinks the appropriate skills/commands directories.
mallard # interactive TUI
mallard install # same as above
mallard install --agent claude # install only to claude (non-interactive)
mallard install --all # install to all detected agents (non-interactive)
mallard update # re-link skills/commands
mallard doctor # check symlink health per agent
mallard registry # list installed skills/commands
mallard version # print versionCommands
| Command | What it does |
|---|---|
mallard | Launch the interactive TUI (same as mallard install). |
mallard install | Install skills + commands. Interactive by default. |
mallard install --agent claude | Install only to a specific agent (non-interactive). |
mallard install --all | Install to all detected agents (non-interactive). |
mallard update | Re-link skills/commands. Backs up conflicts before re-linking. |
mallard update --list-backups | List previous backup snapshots. |
mallard update --restore <ts> | Restore a prior backup by timestamp. |
mallard doctor | Check symlink health per agent. |
mallard registry | List installed skills/commands and surface version drift per agent. |
mallard version | Print the installed version. |
Agent detection
Mallard supports multiple AI agents via an adapter interface. On install /
update it detects which agents are present and links the right directories:
| Agent | Skills | Commands | Agents |
|---|---|---|---|
claude | ✅ ~/.claude/skills/ | ✅ ~/.claude/commands/ | ✅ ~/.claude/agents/ |
codex | ✅ | ✅ | — |
opencode | ✅ | ✅ | — |
generic | ✅ | ✅ | — |
Subagents are Claude-specific, so the Codex / OpenCode / generic adapters skip them.
Backups
mallard update snapshots any conflicting files before re-linking and keeps the
latest 5 snapshots. Recover with:
mallard update --list-backups
mallard update --restore <timestamp>