human setup
human setup
Install integration kits into an existing project. This command writes IDE-specific config under .cursor/ or .claude/ in the target directory.
App Kit vs Agent Developer Kit
| Kit | Command | What it installs |
|---|---|---|
| App Integration Kit | human cursor-init |
Passport auth rules, Companion embed skills |
| Agent Developer Kit | human setup … --agent-kit |
Governance hooks, review skills, audit agents, MCP |
Use Agent Developer Kit when building HUMΛN agents and you want config protection, batch typecheck, and review skills in the harness.
Commands
# Full kit (hooks + skills + agents + MCP) — --agent-kit or --hooks-only is required
human setup cursor --agent-kit
human setup claude-code --agent-kit
# Hooks only
human setup cursor --agent-kit --hooks-only
human setup claude-code --agent-kit --hooks-only
# Preview without writing
human setup cursor --agent-kit --dry-run
# Check for upgrades vs bundled assets
human setup cursor --agent-kit --check
Flags
| Flag | Description |
|---|---|
--target <dir> |
Project root (default: current directory) |
--dry-run |
Print install manifest; do not write files |
--check |
List components that would upgrade |
--hooks-only |
Skip skills, agents, and MCP |
--agent-kit |
Install the agent developer kit (required for kit install) |
What gets written
Cursor (human setup cursor --agent-kit)
| Path | Content |
|---|---|
.cursor/hooks/ |
Governance shell hooks |
.cursor/hooks.json + .cursor/hooks/hooks.json |
Hook registry (both paths; merged with existing entries) |
.cursor/skills/ |
Five human-* skills |
.cursor/agents/ |
Six governance agent descriptors |
.cursor/mcp.json |
human + human-api MCP servers (merged) |
.human/kit.json.example |
Optional backlog / Sentry config template |
Claude Code (human setup claude-code --agent-kit)
| Path | Content |
|---|---|
.claude/hooks/ |
Claude-format governance hooks |
.claude/settings.json |
Merged hooks + mcpServers blocks |
.claude/skills/ |
Same five skills |
.claude/agents/ |
Claude sub-agent format descriptors |
Hook merge behavior
Re-running human setup merges hook registries and MCP config: your custom preToolUse entries are kept; bundled governance hooks are added or updated. MCP HUMAN_API_URL defaults to https://api.haio.run unless you set HUMAN_API_URL in the environment at install time.
jq dependency (Claude Code)
Claude hook scripts use jq for JSON. Install via your OS package manager before using Claude Code hooks. The CLI checks for jq before a full Claude kit install (not for --dry-run or --check).
After install
- Run
human loginto activate MCP servers (HUMAN_DELEGATION_TOKENin MCP env). - Open your agent source and use skills (e.g. code review) or governance agents from the Command Palette.
- Optional: copy
.human/kit.json.example→.human/kit.jsonfor backlog/Sentry settings.