dsh-import-agents

Usage

Quick start

1. Refresh the page after a restart.
2. Click Sync in the composer tool row — or type /import-all in the input.
3. Imported sessions appear in the session list (grouped by workspace); imported agents appear as skills.

Everything is idempotent — run it as often as you like; already-imported sessions are skipped.

Slash commands

Command	What it does
/import-pi [options]	Import pi sessions
/import-opencode [options]	Import opencode sessions
/import-codex [options]	Import codex sessions
/import-claude-code [options]	Import claude-code sessions
/import-agents	Convert pi/opencode agents & prompts into dsh skills
/import-all [options]	All of the above (4 sources + agents)
/attach-workspaces	Attach imported sessions to cwd-matched workspaces (retro-fit)

Options: --limit N · --project · --since · --no-tools · --tools-as-text · --tool-truncate N

CLI (no dsh needed)

node import.mjs all                # dry-run preview (writes nothing)
node import.mjs all --apply        # write sessions + skills
node import.mjs sessions codex --apply --limit 20   # one source at a time
node import.mjs agents --apply     # agents/prompts → skills only
node export.mjs                    # export sessions as Markdown for any agent to read

• import.mjs defaults to dry-run; pass --apply to write.
• all = pi + opencode + agents; add codex/claude-code explicitly (e.g. sessions codex, sessions claude-code).
• export.mjs writes $DSH_HOME/exports/ /.md (--source, --project, --limit, --since, --out, --no-reasoning, --no-tools).

Configuration

Key	Default	Meaning
offerOnStart	true	Ask about migration when a new top-level session starts
piRoot	~/.pi/agent/sessions	pi session root
piAgentRoot	~/.pi/agent	pi agents & prompts root
opencodeDb	~/.local/share/opencode/opencode.db	opencode SQLite path
opencodeConfig	~/.config/opencode	opencode agents root
codexRoot	~/.codex/sessions	codex session root
claudeRoot	~/.claude/projects	claude-code projects root
skillsRoot	$DSH_AGENTS_HOME/skills	skills output root
toolTruncate	1000	tool-call arguments truncation (chars)

The migration prompt only fires for brand-new top-level sessions (startup, not subagents) that have a cwd and unimported history. Per-project decisions and the global agents decision are stored in $DSH_HOME/import-pi-opencode-state.json; headless environments without a UI provider silently skip the prompt.