A task list Claude Code can run as a skill
Claude Code is built around skills it loads on demand. Make task tracking one of them. Add the pt CLI and Claude Code can turn a long terminal session into tracked tasks, then you review and reprioritize from the PerspecTask app.
Why give Claude Code a task manager?
Claude Code is Anthropic's terminal coding agent. It plans multi-step work and runs shell commands, but once the session ends, the plan is gone. PerspecTask gives it a persistent task tree it reads and writes through a CLI, so the work survives across sessions. Those tasks are plaintext so the CLI can read them, while anything you keep end-to-end encrypted stays invisible to the agent and to PerspecTask.
# Expose the PerspecTask CLI to Claude Code as a skill
npm install -g @perspectask/cli
pt auth set --key "pt_live_..."
# Claude Code can run these while it works through a task:
pt tasks create "Migrate auth to sessions" --deadline this-week --priority 1
pt tasks abc --tree # read the plan it saved earlier
pt tasks update abc --status IN_PROGRESSClaude Code already runs shell commands, so the CLI needs no wrapper. It reads the JSON output and keeps moving.
How it fits the Claude Code workflow
Register the skill
Install @perspectask/cli where Claude Code runs and authenticate with a scoped key. It becomes a skill it can call.
Plans become tasks
When Claude Code breaks a job into steps, it writes them as a task tree instead of a throwaway list. Next session it reads the tree back and continues from the right place.
Review in the app
Open the PerspecTask app to reorder priorities, push deadlines, or close work the agent missed. Your account and the agent’s share one encrypted source of truth.
Frequently asked questions
- Can Claude Code track tasks across sessions?
- Yes. Claude Code itself starts fresh each session, but tasks it writes to PerspecTask through the CLI persist. In a new session it runs pt tasks to read the open tree and continue, so multi-step work is not lost when the terminal closes.
- How do I add PerspecTask as a Claude Code skill?
- Install the @perspectask/cli package on the machine Claude Code runs on and authenticate it with a scoped API key. Claude Code can then call pt commands like any other shell tool, no custom wrapper needed.
- Is the task data private?
- PerspecTask tasks are end-to-end encrypted by default, decrypted only in the app with your password. The CLI and API can never read an encrypted task, so Claude Code cannot either. You let it work on plaintext tasks, or decrypt one in the app first. Anything you leave encrypted stays private from the agent and from PerspecTask.
- Can I correct what the agent did?
- Yes. You manage everything from the PerspecTask app on web, iOS, or Android. Any task Claude Code creates or updates appears there for you to edit, reprioritize, reschedule, or delete.
- Does it cost anything?
- PerspecTask is free to start. Create an account, generate an API key, and install the CLI. You can run the whole setup with Claude Code at no cost while you evaluate it.
Give Claude Code a task backend it can drive
Create a free scoped key, add the pt CLI to Claude Code, and steer everything from the PerspecTask app.