What does yosoi agents install write?

It writes packaged Yosoi workflow skills into the selected agent target. For Pi it also writes a Yosoi workflows extension.

Should I install project-local or user-global assets?

Use --scope project to trial assets in a repo or worktree. Use the default --scope user, or agents update, when you want global agent config.

Agent Workflows

Yosoi ships agent-facing workflow assets so coding agents can use the same safe fetch, crawl, search, and research guidance as the docs.

Install

Try project-local assets first when working inside a repo or worktree:

uvx yosoi agents install --scope project --target pi --force

Promote or update user-global assets when ready:

uvx yosoi agents update --target pi
uvx yosoi agents install --target agents

Reload or restart the target agent after install. In Pi, run /reload.

Targets

Target	User-scope skills	Project-scope skills	Extra assets
`pi`	`~/.pi/agent/skills/`	`./.agents/skills/`	user: `~/.pi/agent/extensions/yosoi-workflows.ts`; project: `./.pi/extensions/yosoi-workflows.ts`
`agents`	`~/.agents/skills/`	`./.agents/skills/`	none
`claude`	`~/.claude/skills/`	`./.claude/skills/`	none
`codex`	`~/.codex/skills/`	`./.codex/skills/`	none
`opencode`	`~/.config/opencode/skills/`	`./.config/opencode/skills/`	none
`all`	all targets above	all targets above	Pi extension for `pi`

Installed skills:

yosoi-web-workflows: choose the right Yosoi search, fetch, crawl, or research workflow.
yosoi-fetch: bounded page evidence acquisition without scraping.
yosoi-research-frontier: exploratory source mapping and evidence packets before deterministic scraping.

Safety Behavior

install skips existing files unless --force is passed.
update overwrites existing installed assets by design.
--scope user writes global agent config under your home directory.
--scope project writes repo-local assets under the current working directory.
--dry-run prints what would be written without changing disk.
--json emits a machine-readable install or update record.

Examples

uvx yosoi agents install --scope project --target pi --dry-run
uvx yosoi agents install --target all --force
uvx yosoi agents update --target pi --target codex --json

Back-compatible singular alias:

uvx yosoi agent install --target pi
uvx yosoi agent update --target pi