Sharing via Agent Skills

You can share traces without leaving your agent conversation. Install the sharing instructions once with traces setup skills, then ask the agent to share.

Set up agent sharing

Interactive setup

traces setup skills

Traces scans for installed agents and asks which ones to configure.

Non-interactive setup

traces setup skills --yes

Installs for all detected agents without prompts.

Set up specific agents

traces setup skills --agent claude-code
traces setup skills --agent claude-code opencode cursor

Global setup

traces setup skills --global

Installs into global config directories so the setup works across projects.

Skills only add the sharing instructions and tools. They do not share sessions automatically; for that, see Agent Hooks. For Pi and Oh My Pi, the skill installs a traces.ts extension with the traces_share and traces_list tools, while agent hooks install a separate traces-agent-hooks.ts. Pi and Oh My Pi skills installed by Traces before this split also shared sessions automatically; re-run traces setup skills (add --global for a home-directory install) to replace them.

To remove skills and keep agent hooks, run traces remove skills. To remove both, run traces remove agents.

Remove sharing setup

traces remove agents
traces remove agents --global

Use traces remove agents to remove managed setup from the current project, or --global for home-directory installs.

Supported agent IDs

claude-code, opencode, cursor, codex, pi, cline, amp, copilot, openclaw

For storage formats and detection details, see Supported Agents.

How sharing works in chat

After setup, say any of these inside your agent:

• "share to traces"
• "publish this trace"
• "share this session"
• "upload this to traces"

The agent runs:

traces share --cwd "$PWD" --agent <agent-id> --json

Then it posts the shared URL in the conversation.

Session matching behavior

Agents with session hooks

Claude Code and Cursor can pass active session context, so traces share can target the active session more reliably.

OpenCode plugin support

OpenCode setup installs a plugin that can pass session context to traces share.

Agents without session hooks

Codex, Pi, Cline, Amp, and Copilot generally rely on working-directory matching.

If multiple sessions match, discover first, then share by ID:

traces share --list --cwd . --agent <agent-id> --json
traces share --trace-id <selected-id> --json

Team workflow

For team visibility, share into an org namespace:

traces namespace use my-org

Then keep sharing as normal. Trace links can be dropped into PRs and team channels.

To automatically attach those shared traces to commits, pair this with Sharing via Git Hooks.

Verify and update setup

traces doctor
traces setup skills --yes

traces doctor checks setup health. Re-running traces setup skills refreshes managed files.

Troubleshooting

• Agent does not recognize share phrase: run traces setup skills again
• "No trace found": run traces share --list and share with --trace-id
• Auth errors: run traces login and retry