Documentation
Set up Hostplan for coding agents
Teach Codex, Claude Code, and Cursor when to store, retrieve, approve, and update implementation plans with the Hostplan skill.
Install the skill by symlink
The repository includes a Hostplan skill that teaches an agent when to save a plan, check approval, update progress, and read work created by another session. Symlink it so a Git pull updates the instructions in place.
# Run from the Hostplan repository
ln -sfn "$PWD/skills/hostplan" ~/.codex/skills/hostplan
ln -sfn "$PWD/skills/hostplan" ~/.claude/skills/hostplan
ln -sfn "$PWD/skills/hostplan" ~/.cursor/skills-cursor/hostplanWhat the skill changes
Plans get durable links
hsp add and returns the viewer URL.Drafts do not execute themselves
Progress survives sessions
Revisions keep one identity
Recommended agent flow
- 1
Ask for a plan
The agent researches the actual repository and writes a decision-complete implementation plan.
- 2
Open the Hostplan link
Review the rendered plan and request revisions on the same plan id.
- 3
Approve explicitly
Say go ahead or approve the plan. The implementing agent records that transition.
- 4
Resume in any session
Give another agent the URL or id; it reads the current plan and task state before changing code.
Verify the setup
hsp whoami
hsp add -c "# Skill smoke test\n\n- [ ] Verify retrieval" -t "Skill smoke test"
hsp get latest
hsp tasks latestIf hsp is not found, install it with bun add --global hostplan. If hosted URLs are expected but hsp whoami reports local-only mode, run hsp login.
Security boundary
The skill coordinates plan files; it does not grant broader permission to publish code, push branches, expose private plans, or perform destructive actions. Existing repository and user instructions still control those actions.