Genie CLI

Collaborative 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.

---

What you get (features)

$3

Genie provides a set of skills (slash commands like /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.

$3

- Installs/links the Claude plugin at ~/.claude/plugins/automagik-genie
- Ships skills + agents + hooks

$3

- Installs/links an OpenClaw plugin with the same id: automagik-genie
- The plugin exposes the same skills to OpenClaw so they can appear as global slash commands (depending on your OpenClaw config)

> Note: after installing an OpenClaw plugin you typically need to restart the OpenClaw Gateway to load it.

---

Repository layout (important)

``./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.

---

`Quick start`

`$3`

`bash curl -fsSL https://raw.githubusercontent.com/namastexlabs/genie-cli/main/install.sh | bash`

`$3`

`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

---

`install.sh flags`

`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`

---

`Claude Code plugin`

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 -> /plugins/automagik-genie

Verify:

`bash claude plugin list | rg automagik-genie`

---

`OpenClaw plugin`

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`

---

`Configuration files`

| 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 |

---

genie `reference`

`$3`

`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 |

`$3`

`bash genie setup # Interactive wizard genie setup --quick # Use recommended defaults (collaborative + audited)`

`$3`

`bash genie hooks show

genie hooks install genie hooks install --force

genie hooks uninstall genie hooks uninstall --keep-script

genie hooks test`

---

`Hook presets`

`$3`

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" } } }`

`$3`

What: File changes require your approval

Example config:

`json { "hooks": { "enabled": ["supervised"], "supervised": { "alwaysAsk": ["Write", "Edit"] } } }`

`$3`

What: Restrict file access to specific directories

Example config:

`json { "hooks": { "enabled": ["sandboxed"], "sandboxed": { "allowedPaths": ["~/projects", "/tmp"] } } }`

`$3`

What: Log all AI tool usage to a file

Example config:

`json { "hooks": { "enabled": ["audited"], "audited": { "logPath": "~/.genie/audit.log" } } }`

`$3`

`json { "hooks": { "enabled": ["collaborative", "audited"] } }`

---

`Worker Profiles`

Worker profiles configure how genie-cli spawns Claude Code workers. Each profile bundles a launcher (claude or claudio) with CLI arguments.

`$3`

`bash genie profiles list # List all profiles (* = default) genie profiles add # Add new profile (interactive) genie profiles show # Show profile details genie profiles rm # Delete profile genie profiles default # Set default profile`

`$3`

`bash term spawn implementor --profile coding-fast # Use specific profile term work bd-123 --profile autonomous # Complex task with opus`

`$3`

`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.

---

term `reference`

`$3`

`term ├── new Create session (-d workspace, -w worktree) ├── ls List sessions (--json) ├── attach Attach interactively ├── rm Remove session (--keep-worktree) ├── read Read output (-n, --grep, --json, -f) ├── exec Run command (async) ├── send Send keys with Enter (--no-enter for raw) ├── split Split pane (-d, -w) ├── info Session info (--json) ├── watch Watch events in real-time ├── run Fire-and-forget with auto-approve ├── window │ ├── new │ ├── ls (--json) │ └── rm ├── pane │ ├── ls (--json) │ └── rm ├── orc │ ├── start Start Claude with monitoring │ └── status Claude state (idle/busy/permission) └── hook ├── set ├── list └── rm`

`$3`

| 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 |

---

claudio `reference`

claudio launches Claude Code with custom LLM routing profiles.

Key principle: claude = vanilla Anthropic, claudio = your custom router setup.

`$3`

`claudio Launch with default profile claudio Launch with named profile

claudio setup First-time setup wizard claudio profiles List all profiles (* = default) claudio profiles add Add new profile claudio profiles rm Delete profile claudio profiles default Set default profile claudio profiles show Show profile details

claudio models List available models from router claudio config Show current config`

Config lives in ~/.claudio/config.json.

---

`Uninstall`

`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)

---

License

MIT

Genie CLI

Collaborative terminal toolkit for human + AI workflows.

Genie CLI ships three CLIs:

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.

---

What you get (features)

$3

Genie provides a set of skills (slash commands like /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.

$3

- Installs/links the Claude plugin at ~/.claude/plugins/automagik-genie
- Ships skills + agents + hooks

$3

> Note: after installing an OpenClaw plugin you typically need to restart the OpenClaw Gateway to load it.

---

Repository layout (important)

This ensures one SKILL.md per skill, reused by both ecosystems.

---

`Quick start`

`$3`

`bash curl -fsSL https://raw.githubusercontent.com/namastexlabs/genie-cli/main/install.sh | bash`

`$3`

`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

---

`install.sh flags`

`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`

---

`Claude Code plugin`

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 -> /plugins/automagik-genie

Verify:

`bash claude plugin list | rg automagik-genie`

---

`OpenClaw plugin`

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`

---

`Configuration files`

---

genie `reference`

`$3`

`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

`$3`

`bash genie setup # Interactive wizard genie setup --quick # Use recommended defaults (collaborative + audited)`

`$3`

`bash genie hooks show

genie hooks install genie hooks install --force

genie hooks uninstall genie hooks uninstall --keep-script

genie hooks test`

---

`Hook presets`

`$3`

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" } } }`

`$3`

What: File changes require your approval

Example config:

`json { "hooks": { "enabled": ["supervised"], "supervised": { "alwaysAsk": ["Write", "Edit"] } } }`

`$3`

What: Restrict file access to specific directories

Example config:

`json { "hooks": { "enabled": ["sandboxed"], "sandboxed": { "allowedPaths": ["~/projects", "/tmp"] } } }`

`$3`

What: Log all AI tool usage to a file

Example config:

`json { "hooks": { "enabled": ["audited"], "audited": { "logPath": "~/.genie/audit.log" } } }`

`$3`

`json { "hooks": { "enabled": ["collaborative", "audited"] } }`

---

`Worker Profiles`

Worker profiles configure how genie-cli spawns Claude Code workers. Each profile bundles a launcher (claude or claudio) with CLI arguments.

`$3`

`bash term spawn implementor --profile coding-fast # Use specific profile term work bd-123 --profile autonomous # Complex task with opus`

`$3`

For full documentation, see docs/worker-profiles.md.

---

term `reference`

`$3`

---

claudio `reference`

claudio launches Claude Code with custom LLM routing profiles.

Key principle: claude = vanilla Anthropic, claudio = your custom router setup.

`$3`

`claudio Launch with default profile claudio Launch with named profile

claudio models List available models from router claudio config Show current config`

Config lives in ~/.claudio/config.json.

---

`Uninstall`

`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)

---

License

MIT

@automagik/genie

Genie CLI

What you get (features)

$3

$3

$3

Repository layout (important)

Quick start

$3

$3

install.sh flags

Claude Code plugin

OpenClaw plugin

Configuration files

genie reference

$3

$3

$3

Hook presets

$3

$3

$3

$3

$3

Worker Profiles

$3

$3

$3

term reference

$3

$3

claudio reference

$3

Uninstall

License

@automagik/genie

Genie CLI

What you get (features)

$3

$3

$3

Repository layout (important)

Quick start

$3

$3

install.sh flags

Claude Code plugin

OpenClaw plugin

Configuration files

genie reference

$3

$3

$3

Hook presets

$3

$3

$3

$3

$3

Worker Profiles

$3

$3

$3

term reference

$3

$3

claudio reference

$3

Uninstall

License

`Quick start`

`$3`

`$3`

`install.sh flags`

`Claude Code plugin`

`OpenClaw plugin`

`Configuration files`

genie `reference`

`$3`

`$3`

`$3`

`Hook presets`

`$3`

`$3`

`$3`

`$3`

`$3`

`Worker Profiles`

`$3`

`$3`

`$3`

term `reference`

`$3`

`$3`

claudio `reference`

`$3`

`Uninstall`

`Quick start`

`$3`

`$3`

`install.sh flags`

`Claude Code plugin`

`OpenClaw plugin`

`Configuration files`

genie `reference`

`$3`

`$3`

`$3`

`Hook presets`

`$3`

`$3`

`$3`

`$3`

`$3`

`Worker Profiles`

`$3`

`$3`

`$3`

term `reference`

`$3`

`$3`

claudio `reference`

`$3`

`Uninstall`