Collaborative terminal toolkit for human + AI workflows
npm install @automagik/genieCollaborative terminal toolkit for human + AI workflows.
Genie CLI ships three CLIs:
- genie — setup wizard, prerequisites installer, and hook management
- term — tmux orchestration for managing terminal sessions (AI-safe)
- claudio — Claude Code launcher with custom LLM routing profiles
Core idea: tmux is the collaboration layer. AI agents run inside shared tmux sessions; humans can attach at any time to watch, assist, or take over.
---
/brainstorm, /wish, etc.) that can be loaded in:- Claude Code via the automagik-genie Claude plugin
- OpenClaw via the automagik-genie OpenClaw plugin
✅ Single source of truth: all skills live in ./skills/ at the repo root.
~/.claude/plugins/automagik-genieautomagik-genie> Note: after installing an OpenClaw plugin you typically need to restart the OpenClaw Gateway to load it.
---
```
./skills/ # ✅ canonical skills directory
./plugins/automagik-genie/ # Claude Code + OpenClaw plugin wrapper
├── .claude-plugin/ # Claude Code plugin manifest
├── openclaw.plugin.json # OpenClaw plugin manifest
├── automagik-genie.ts # OpenClaw standalone extension entrypoint
└── skills -> ../../skills # symlink to canonical skills
This ensures one SKILL.md per skill, reused by both ecosystems.
---
`bash`
curl -fsSL https://raw.githubusercontent.com/namastexlabs/genie-cli/main/install.sh | bash
`bash`
./install.sh --local /path/to/genie-cli --dev
- --local builds from source and npm links the CLI--dev
- links the OpenClaw plugin instead of copying it
---
`text`
--local PATH Install from local source directory (for development)
--dev, -d Dev mode: link OpenClaw plugin instead of copying
uninstall Remove Genie CLI and components
---
During install, you can choose to install the Claude Code plugin.
- If using a local clone, the installer creates a symlink:
- ~/.claude/plugins/automagik-genie ->
Verify:
`bash`
claude plugin list | rg automagik-genie
---
During install, you can choose to install the OpenClaw plugin.
Under the hood, OpenClaw installs the standalone extension entrypoint:
- plugins/automagik-genie/automagik-genie.ts
Verify:
`bash`
openclaw plugins list | rg automagik
Then restart the gateway:
`bash`
openclaw gateway restart
---
| File | Purpose |
|------|---------|
| ~/.genie/config.json | Hook presets and session settings |~/.claudio/config.json
| | LLM routing profiles (API URL, model mappings) |~/.claude/settings.json
| | Claude Code settings (hooks registered here) |~/.claude/hooks/genie-bash-hook.sh
| | Hook script enforcing configured behaviors |
---
reference`bash`
genie install # Interactive prerequisite check & install
genie install --check # Only check, don't offer to install
genie install --yes # Auto-approve all installations
What it checks
| Prerequisite | Required | Installation Method |
|--------------|----------|---------------------|
| tmux | Yes | brew > apt/dnf/pacman > manual |
| bun | Yes | Official installer (curl) |
| claude | No (recommended) | npm/bun global install |
`bash`
genie setup # Interactive wizard
genie setup --quick # Use recommended defaults (collaborative + audited)
`bash
genie hooks show
genie hooks install
genie hooks install --force
genie hooks uninstall
genie hooks uninstall --keep-script
genie hooks test
`
---
What: All terminal commands run through tmux
Why: You can watch AI work in real-time
How: Bash commands are rewritten to term exec
`bash`
tmux attach -t genie
Example config:
`json`
{
"hooks": {
"enabled": ["collaborative"],
"collaborative": {
"sessionName": "genie",
"windowName": "shell"
}
}
}
What: File changes require your approval
Example config:
`json`
{
"hooks": {
"enabled": ["supervised"],
"supervised": {
"alwaysAsk": ["Write", "Edit"]
}
}
}
What: Restrict file access to specific directories
Example config:
`json`
{
"hooks": {
"enabled": ["sandboxed"],
"sandboxed": {
"allowedPaths": ["~/projects", "/tmp"]
}
}
}
What: Log all AI tool usage to a file
Example config:
`json`
{
"hooks": {
"enabled": ["audited"],
"audited": {
"logPath": "~/.genie/audit.log"
}
}
}
`json`
{ "hooks": { "enabled": ["collaborative", "audited"] } }
---
Worker profiles configure how genie-cli spawns Claude Code workers. Each profile bundles a launcher (claude or claudio) with CLI arguments.
`bash`
genie profiles list # List all profiles (* = default)
genie profiles add
genie profiles show
genie profiles rm
genie profiles default
`bash`
term spawn implementor --profile coding-fast # Use specific profile
term work bd-123 --profile autonomous # Complex task with opus
`json`
{
"workerProfiles": {
"coding-fast": {
"launcher": "claudio",
"claudioProfile": "coding-fast",
"claudeArgs": ["--dangerously-skip-permissions"]
},
"safe": {
"launcher": "claude",
"claudeArgs": ["--permission-mode", "default"]
}
},
"defaultWorkerProfile": "coding-fast"
}
For full documentation, see docs/worker-profiles.md.
---
reference``
term
├── new
├── ls List sessions (--json)
├── attach
├── rm
├── read
├── exec
├── send
├── split
├── info
├── watch
├── run
├── window
│ ├── new
│ ├── ls
│ └── rm
├── pane
│ ├── ls
│ └── rm
├── orc
│ ├── start
│ └── status
└── hook
├── set
├── list
└── rm
| Option | Description |
|------|-------------|
| --json | Output as JSON (essential for agents) |-n
| | Number of lines to read |-f
| | Follow mode (live tail) |-d
| | Working directory |-w
| | Create git worktree |--grep
| | Filter output by pattern |
---
referenceclaudio launches Claude Code with custom LLM routing profiles.
Key principle: claude = vanilla Anthropic, claudio = your custom router setup.
`
claudio Launch with default profile
claudio
claudio setup First-time setup wizard
claudio profiles List all profiles (* = default)
claudio profiles add Add new profile
claudio profiles rm
claudio profiles default
claudio profiles show
claudio models List available models from router
claudio config Show current config
`
Config lives in ~/.claudio/config.json.
---
`bash`
curl -fsSL https://raw.githubusercontent.com/namastexlabs/genie-cli/main/install.sh | bash -s -- uninstall
The uninstaller will offer to remove:
- the Genie CLI package
- Claude Code plugin
- OpenClaw plugin (disable + remove extension dir)
- ~/.genie` config directory (optional; default is to keep)
---
MIT