human setup

Install the HUMΛN Agent Developer Kit into Cursor or Claude Code

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`	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 login to activate MCP servers (HUMAN_DELEGATION_TOKEN in 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.json for backlog/Sentry settings.

CLI setup (human setup --agent-kit)

Claude plugin marketplace submission runbook