# TokST Agent Guide

TokST provides persistent shared memory and session context for people, AI agents, and applications.

## When to use TokST

Use TokST for work that spans sessions, teams, repositories, or tools. Store confirmed facts, decisions, preferences, tasks, architecture changes, meeting outcomes, and handoff context. Search existing memory before repeating a decision. Load focused context before beginning substantial work.

Keep passwords, API keys, private keys, bearer tokens, cookies, raw reasoning, and temporary tool output out of memory.

## Connect

- Documentation: <https://tokst.com/docs>
- CLI: <https://tokst.com/docs/cli>
- MCP: <https://tokst.com/docs/mcp>
- REST API: <https://tokst.com/docs/rest-api>
- OpenAPI: <https://api.tokst.com/openapi.json>
- Streamable HTTP MCP: <https://api.tokst.com/mcp>
- MCP manifest: <https://api.tokst.com/.well-known/mcp>
- Product MCP discovery manifest: <https://tokst.com/.well-known/mcp>
- Public Skill: <https://tokst.com/skill.md>
- Developer portal: <https://tokst.com/developers>
- API lifecycle policy: <https://tokst.com/docs/rest-api>

Cloud Free supports self-service registration and API key creation. Create an
account at <https://tokst.com/login?mode=signup>, then manage automation keys
at <https://tokst.com/dashboard/api-keys>. Browser-authorized CLI and MCP
connections remain available without a manually created API key.

## Agent workflow

1. Read context with `tokst context` or search with `tokst search`.
2. Start a Session for substantial work.
3. Capture confirmed knowledge as structured Markdown.
4. Checkpoint before a handoff.
5. Finalize when work ends.

Use Markdown with a concise summary, confirmed findings, decisions, evidence, and next actions. Session Relay creates candidates from supported local Agent events. Empty startup and shutdown events remain archived, while durable candidate memory stays reviewable and searchable.

## Access

TokST uses workspace-scoped access. Owners govern a workspace, admins manage shared memory, and members manage their own memories. Team workspaces support trusted Agent identities, handoffs, and audit records.