One task list across every Codex surface
Codex runs in your terminal, your IDE, and the cloud. Give it one task list that follows along. Add the pt CLI and Codex can log and update work wherever it runs, while you keep the master view in the PerspecTask app.
Why pair Codex with PerspecTask?
OpenAI Codex is a coding agent that works across the terminal, IDE, web, and cloud, all tied to your account. Each surface can spin off work, which is easy to lose track of. PerspecTask gives Codex one shared task tree it updates through a CLI. 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.
# Make the PerspecTask CLI available to Codex
npm install -g @perspectask/cli
pt auth set --key "pt_live_..."
# Codex can log and track work from any surface it runs on:
pt tasks create "Fix flaky checkout test" --deadline today --priority 1
pt tasks # the same open list, terminal or cloud
pt tasks update 9d2 --status COMPLETEDWhether Codex runs locally or in a cloud environment, it talks to the same task list, so parallel agents do not lose the thread.
How it fits across Codex surfaces
Install the CLI
Add @perspectask/cli to the environment Codex runs in and authenticate with a scoped key. Local or cloud, same setup.
One list, every surface
Codex in the terminal, the IDE, and the cloud all read and write the same tasks. Work started in one place shows up in the others, so nothing falls through the cracks between runs.
You hold the master view
The PerspecTask app is your control panel. Reprioritize, reschedule across day to year views, and check progress while Codex keeps the list current from wherever it runs.
Frequently asked questions
- Can Codex use the same task list in the terminal and the cloud?
- Yes. The PerspecTask CLI talks to your account over the API, so any Codex surface, local terminal or cloud environment, reads and updates the same task list. A task created in one place is immediately visible in the others.
- How does Codex update tasks?
- Codex runs shell commands, so it calls the pt CLI directly: create tasks, set deadlines and priorities, read the open tree, and mark work complete. The CLI returns JSON, which Codex parses to decide the next step.
- Are my tasks 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 Codex 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 override the agent from the app?
- Yes. You manage everything from the PerspecTask app on web, iOS, or Android. Any task Codex creates or changes shows up for you to reprioritize, reschedule, or remove.
- Is it free to try with Codex?
- Yes. PerspecTask is free to start. Make an account, generate an API key, and install the CLI, then point Codex at it from any surface you use.
Give Codex a task backend it can drive
Create a free scoped key, add the pt CLI to Codex, and steer everything from the PerspecTask app.