llms.txt
Compare with other sites' llms.txt files →# PerspecTask
> PerspecTask is an end-to-end encrypted task manager for planning goals from a single day up to a whole life: tasks nest into hierarchies (a task can have several parents), are scheduled into days, weeks, months, quarters, years or "lifetime", and track time with timers. AI agents can read and manage a user's tasks through an MCP server, a CLI, a TypeScript SDK, or the REST API.
Agents can only read and change PLAINTEXT tasks. End-to-end encrypted tasks are decrypted only in the user's browser; over the API they are left out of lists unless `includeEncrypted` is set (then they come back as placeholders with `encrypted: true` and no title or description), tree views keep one only when it sits above a readable task, and writes to them are refused. A list without `includeEncrypted` is therefore not a count of everything the user has. That is a cryptographic fact, not a permission setting.
## Connect an agent
1. The user creates an API key in the web app: https://app.perspectask.com/account → API Keys. Keys start with `pt_live_`. Scopes: `tasks:read`, `tasks:write`, and `tasks:write:meta` (status, priority, deadline and parents, but never the title or description of an existing task). Pass it as the `PERSPECTASK_API_KEY` environment variable.
2. Then use ONE of:
- MCP server (configure once, loads in every session): command `npx -y @perspectask/mcp@latest` with `PERSPECTASK_API_KEY` set. Tools: `perspectask_list_tasks`, `perspectask_get_task`, `perspectask_create_task`, `perspectask_update_task`.
- CLI (works in the same session, no config): `npm install -g @perspectask/cli`, then `pt tasks`. JSON output by default. Full command reference for agents: https://unpkg.com/@perspectask/cli/SKILL.md
- TypeScript SDK: `npm install @perspectask/sdk`
- REST API: `https://api.perspectask.com/v1`, header `Authorization: Bearer pt_live_...`. OpenAPI spec: https://api.perspectask.com/v1/openapi.yaml
Conventions: task ids are git-style short prefixes (`a3f`) and are accepted anywhere an id is; deadlines are one shorthand token, dashed so it survives a shell (`today`, `next-week`, `q3`, `w15`, `y2027`, `lifetime`); unset fields are omitted from responses; the list hides COMPLETED and CANCELLED tasks unless `showCompleted` is set.
## Docs
- [PerspecTask for agents](https://perspectask.com/agents): API, SDK, CLI and MCP overview with setup steps
- [API reference](https://perspectask.com/docs): every endpoint, generated from the OpenAPI spec
- [MCP server](https://perspectask.com/tasks-mcp): tools, client config, MCP vs CLI
- [CLI](https://perspectask.com/tasks-cli): `pt` commands, SKILL.md, deadline tokens
- [TypeScript SDK](https://perspectask.com/tasks-sdk): typed client, `{ data, error }`, Zod schemas
- [REST API](https://perspectask.com/tasks-api): endpoints, auth, error codes, OpenAPI spec
- [@perspectask/mcp on npm](https://www.npmjs.com/package/@perspectask/mcp)
- [@perspectask/cli on npm](https://www.npmjs.com/package/@perspectask/cli)
- [@perspectask/sdk on npm](https://www.npmjs.com/package/@perspectask/sdk)
## Per-agent guides
Each guide below is also plain markdown with the setup steps an agent follows: append `.md` to its URL (https://perspectask.com/muse.md). The general version is https://perspectask.com/agents.md.
- [OpenClaw](https://perspectask.com/openclaw): CLI as a skill
- [Hermes](https://perspectask.com/hermes): CLI as a skill
- [Muse](https://perspectask.com/muse): MCP server as a custom connector
- [ChatGPT dots](https://perspectask.com/chatgpt-dots): CLI on the dot's cloud computer
- [Claude Cowork](https://perspectask.com/claude-cowork): CLI in the session, installed per task
- [Manus](https://perspectask.com/manus): CLI in the sandbox, key as a custom API secret
- [Perplexity Computer](https://perspectask.com/perplexity-computer): REST API, key in the Credential vault
- [Grok Bot](https://perspectask.com/grok-bot): CLI on the cloud computer, key as a Bot Secret
- [Claude Code](https://perspectask.com/claude-code): CLI as a skill
- [Codex](https://perspectask.com/codex): CLI
- [Cursor](https://perspectask.com/cursor): MCP server in `~/.cursor/mcp.json`
- [Kiro](https://perspectask.com/kiro): MCP server in `~/.kiro/settings/mcp.json`, rules in steering files
- [Gemini CLI](https://perspectask.com/gemini-cli): MCP server via `gemini mcp add`
- [Kimi Code](https://perspectask.com/kimi-code): MCP server in `~/.kimi-code/mcp.json`
## Optional
- [Web app](https://app.perspectask.com)
- [Pricing](https://perspectask.com/#pricing)
- [Free tools](https://perspectask.com/tools): every free tool, no account needed
- [24 hour clock](https://perspectask.com/tools/24-hour-clock): free live analog 24 hour clock (one turn per day, 24 at the top); highlight periods such as an eating window or sleep as colored bands; full screen, time zones, 12/24 hour and military time chart
- [Pomodoro timer](https://perspectask.com/tools/pomodoro): free online Pomodoro timer
- [Privacy](https://perspectask.com/privacy)