How Project Memory Works

Start blank, use a built-in template, or import a Project Memory export when your plan allows it.

Set Current Status, Next Action, and Important Context, then add tasks or issues for concrete work.

The web app and official CLI use the same projects, sessions, activity, and Project Memory.

Project members see one shared memory state rather than maintaining separate handoff documents.

Memory fields change only when you edit them or publish a reviewed update. Ordinary navigation does not rewrite memory.

Capture where the project stands so you can resume with confidence.

Write the next move directly, create and link a task, or link an existing task or issue.

Keep constraints, assumptions, architectural reminders, and other durable context close to the work.

Track project-level blockers and known problems alongside the memory they affect.

The first meaningful project change starts a session automatically after the previous session has ended. Viewing, navigation, and search do not start one.

Running pm resume creates or resumes the same active backend session used by the web app.

Collaborators have individual sessions while working against the same project context and history.

Open a project to review its memory, open work, recent session, and GitHub context without changing project status.

Use pm resume to show the project name, session state, memory fields, open issues, and open tasks.

When eligible, an optional AI Assist can draft a resume brief. It requires confirmation and never silently changes Project Memory.

Review completed tasks, resolved issues, commits, closed GitHub issues, changed files, discussions, outcomes, and optional notes associated with the session.

The web drawer finalizes the session first, then offers a gentle optional Project Memory update.

pm session end uses the same review and finalization services, with optional terminal prompts for memory review.

An optional AI Assist can draft a handoff after deterministic review. You choose whether to publish any suggested memory changes.

Prioritize, schedule, snooze, assign, complete, reopen, and optionally connect completed work to Git commits.

Create, resolve, reopen, or link issues as Next Action while preserving resolution history.

When linked work changes title or becomes unavailable, Project Memory keeps the relationship understandable and offers a gentle review prompt.

Capture reference material, investigation results, and working observations.

Record what was decided, why it matters, and the project context related to it.

Keep documentation, designs, deployments, and other project resources easy to find.

Review commits, pull requests, GitHub issues, and changed files without exporting credentials or installation metadata.

Automatic commit and changed-file sync follows the connected repository activity available from GitHub. Work that exists only in a local branch is not visible until it is pushed.

Import GitHub issues as tasks and link commits to completed tasks while preserving local Project Memory workflows.

Connection and repository management stay in the web app; the CLI can use local Git context for matching and commit links.

Free includes limited collaboration, while paid plans increase collaborative-project and member capacity. Owners can invite Full Access members or Contributors, with the same backend permissions enforced for web and CLI.

Assign tasks and preserve who created, updated, completed, or resolved collaborative work.

The project owner's plan controls collaborative capacity. Shared projects do not count as owned projects for collaborators.

Start discussions from supported tasks, issues, decisions, Project Memory fields, or GitHub issues where available.

Resolve a discussion with a summary and optionally preserve the outcome as a task, issue, or decision.

Eligible plans can use an optional AI Assist to draft a discussion outcome for review before resolution.

Install with pipx, authorize a device in the browser, and use pm doctor when configuration needs checking.

Resume projects, manage tasks and issues, capture notes, update memory, link commits, and end sessions.

The CLI Dashboard contains searchable commands, examples, device status, quick start, and troubleshooting.

Project Memory shows the feature, available balance, and expected cost before generation.

Smart Resume, Smart Handoff, and discussion outcome assists return drafts that remain separate until you approve them.

Usage is charged to the project owner and records the feature, project, and collaborator who initiated it.