Agent Onboarding

Aug 28, 2026

Copy one prompt, paste it into whatever agent you already use, and watch your agent walk itself through install, login, and your first shared session.

One prompt, the whole setup

Copy a single line below or via the Copy setup prompt button here:

Read https://traces.com/start.md then set me up on Traces.

Paste that into your agent, or type it yourself, and it fetches start.md. This is a public skill anyone can read without an account or API key. There's a team variant too ("set my team up on Traces"), which routes the same skill toward creating or reusing an organization.

What the agent does

The skill is state-aware; it can detect what's already been done and skip it, rather than re-running steps. The setup path is:

Confirm it can identify this session. The agent checks it has an authoritative traces ID or source-path hint for the current conversation, and stops if it doesn't.
Install the CLI if missing. It reads the installation guide and picks the right command for your platform.
Log in only if needed. It runs a traces whoami, and only runs traces login when you're not authenticated.
Inspct your workspaces. traces namespace list identifies your personal workspace and any organizations you belong to.

Then it splits by route

Individual. Privately shares exact setup session to your personal workspace, and returns your profile URL plus the private trace URL.
Team. Creates or reuses the organization, privately shares the session, resolves the default invite, and hands back the org URL, trace URL, invite link, and invite message.

Nothing installed without your approval

Onboarding stops at identity plus that first private share. Agent skills, agent hooks, git hooks, and Github stay opt-in. The skill only offers them as next actions and never installs them unless you explicitly choose to.

In short

Prefer to click through it? Our regular onboarding flow still walks you through the same steps, but if you're ready for your agent to take over start with a single prompt: Read https://traces.com/start.md then set me up on Traces.

One prompt, the whole setup

Copy a single line below or via the Copy setup prompt button here:

Read https://traces.com/start.md then set me up on Traces.

What the agent does

The skill is state-aware; it can detect what's already been done and skip it, rather than re-running steps. The setup path is:

Confirm it can identify this session. The agent checks it has an authoritative traces ID or source-path hint for the current conversation, and stops if it doesn't.

Install the CLI if missing. It reads the installation guide and picks the right command for your platform.

Inspct your workspaces. traces namespace list identifies your personal workspace and any organizations you belong to.

Then it splits by route

Individual. Privately shares exact setup session to your personal workspace, and returns your profile URL plus the private trace URL.

Team. Creates or reuses the organization, privately shares the session, resolves the default invite, and hands back the org URL, trace URL, invite link, and invite message.