What this page is

This is the entrypoint for CLI onboarding. The CLI prints a signed handoff URL that opens /cli/register for browser proof completion.

Human registration flow (today)

1. Create session: self-agent register init --mode agent-identity --human-address 0x... --network testnet --out .self/session.json
2. Get handoff URL: self-agent register open --session .self/session.json
3. Complete Self proof in browser (and passkey step for smart-wallet mode).
4. Finalize in terminal: self-agent register wait --session .self/session.json

Human deregistration flow (today)

1. Create session: self-agent deregister init --mode verified-wallet --human-address 0x... --network testnet --out .self/session-deregister.json
2. Get handoff URL: self-agent deregister open --session .self/session-deregister.json
3. Complete Self proof in browser.
4. Finalize in terminal: self-agent deregister wait --session .self/session-deregister.json

Agent-guided flow (recommended pattern)

Your backend or agent runtime can orchestrate the same commands, then send the handoff URL to the user.

1. Backend calls {register|deregister} init and stores session state.
2. Backend calls {register|deregister} open and forwards URL to user UI.
3. User completes browser proof flow.
4. Backend runs {register|deregister} wait and records the returned lifecycle state.

Language entrypoints

• TypeScript: self-agent ... (or self-agent-cli ...)
• Python: python -m self_agent_sdk.cli ...
• Rust: self-agent-cli ...

Full protocol details are in repository docs: docs/CLI_REGISTRATION_SPEC.md and docs/CLI_REGISTRATION_GUIDE.md on GitHub .