zagents

Scaffold your own focused AI agent gemini — like ruflo, uniquely yours.

Published as zagents (the zagents and gemini CLIs). Earlier versions were published as create-agent-gemini.

Quick start

npx zagents my-bot

You'll be prompted for template, host, description. Out comes a complete npm package ready to npm publish.

Non-interactive

npx zagents my-legal-bot \
  --template vertical:legal \
  --host claude-code \
  --description "Contract redline + risk rating"

Templates

| Template | Best for | |---|---| | minimal | Custom starter — kernel only | | vertical:devops | Incident response, on-call workflows | | vertical:support | Customer support, KB-RAG, escalation | | vertical:trading | Quant trading (paper-default, circuit breakers) | | vertical:legal | Contract review with citation checking | | vertical:research | Multi-source dossier with evidence grading |

Hosts

--host selects which host adapter ships with your gemini:

| Host | What you get | |---|---| | claude-code | .claude/settings.json with MCP + hooks | | codex | ~/.codex/config.toml with [mcp_servers.*] | | pi-dev | Pi extension (TypeScript, no MCP by design) | | hermes | cli-config.yaml + optional-mcps/*.yaml | | openclaw | ~/.openclaw/openclaw.json + workspace SKILL.md + install runbook | | rvm | RVM partition manifest + capability table + wasm-guest + install runbook (hardware-isolated) |

Multi-host: pass --host multiple times.

Also ships the gemini CLI

gemini sign      # produce/update the witness manifest
gemini verify    # check signature
gemini doctor    # smoke-check a scaffolded gemini
gemini help

Eject from ruflo

If you've been using ruflo and want your own focused gemini from it:

npx zagents --from-existing ./

Lifts agents/skills/commands, rewrites every ruflo / claude-flow reference, preserves attribution blocks marked with <!-- ruflo-attribution-block -->.

Full walkthrough

See USAGE.md.

License

MIT