@e9n/pi-workon

Project context switching and initialization for pi — switch projects, detect stacks, scaffold AGENTS.md

Package details

extensionskill

Install @e9n/pi-workon from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@e9n/pi-workon

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

Project context switching for pi — switch between projects, load AGENTS.md and git status, detect tech stacks, and scaffold project configs.

workon tool — switch project context, loading AGENTS.md, git status, and open td issues
project_init tool — detect tech stack and scaffold AGENTS.md, .pi/, and td task tracking
Auto-discovery — scans ~/Dev (or a custom directory) for projects
Bundled skills — includes a workon skill for use in prompt templates

Add to ~/.pi/agent/settings.json or .pi/settings.json:

{
  "pi-workon": {
    "devDir": "~/Dev"
  }
}

Setting	Default	Description
`devDir`	`"~/Dev"`	Base directory scanned for projects

Action	Required params	Description
`switch`	`project`	Switch to a project — loads AGENTS.md, git status, and td issues
`status`	—	Show current project context
`list`	—	List all projects in `devDir` with git branch, AGENTS.md, and td badges

Action	Required params	Description
`detect`	`project`	Scan project and preview what would be generated (dry run)
`init`	`project`	Scaffold AGENTS.md, `.pi/settings.json`, and run `td init`
`batch`	—	Scan all projects in `devDir` and report init status

Init options: force (overwrite existing AGENTS.md), skip_td, skip_agents_md, skip_pi_dir

pi install npm:@e9n/pi-workon

MIT