--- title: "The past-dev command line" description: "past-dev creates a project with no account, sends data points, waits for them and recalls, from a terminal or from a coding agent." canonical: https://past.dev/docs/memory-api/cli last-updated: 2026-11-18 --- # The past-dev command line > past-dev creates a project with no account, sends data points, waits for them and recalls, from a terminal or from a coding agent. Product: past.dev Memory API. Source: https://past.dev/docs/memory-api/cli `past-dev` is on npm and needs Node.js 18 or later. Run it with `npx -y past-dev@latest`. `npm install -g past-dev` gives the same commands as `past-dev`. The package named `past` on npm belongs to someone else, so do not run `npx past`. ```terminal npx -y past-dev@latest init npx -y past-dev@latest ingest "Renewal moved to March 12, 2026 per Dana." \ --timestamp 2026-01-08T09:14:00Z --identity dana@example.com npx -y past-dev@latest ingestion --wait npx -y past-dev@latest recall "When is the renewal?" --identity dana@example.com npx -y past-dev@latest claim ``` ### Start with no account `init` creates an unclaimed project and writes its project key to the env file your framework reads, such as `.env.local`. The project works like a new Pay as you go account. `claim` opens the console, where you sign in or sign up and approve, and the project is then yours. A project that nobody claims is deleted with everything in it 7 days after `init`, and each response to its key carries the date in the `X-Past-Unclaimed-Until` header. A coding agent follows the same steps from [/SKILL.md](https://past.dev/SKILL.md). Before the claim, the key opens every route on the memory of its own project. A route that manages projects and keys returns `402 claim-required` until a person owns the project. ### CLI commands | Command | What it does | | --- | --- | | `init` | Creates an unclaimed project and writes its key. `--for coding-agent --identity ` sets up memory for your own coding sessions. | | `claim` | Makes the project yours. It opens the console in your browser. Where it cannot open a browser, it prints a link, and you give it the code the page shows with `claim --code`. | | `status` | Shows the project, whether it is claimed, and the date it is deleted if it is not. | | `abandon` | Ends an unclaimed project and removes its key from the file. | | `ingest ` | Sends one data point with `POST /api/v1/ingest`. `--id`, `--timestamp`, `--label`, `--audience` and `--identity` set the fields of the same names. `-` as the text reads standard input. | | `ingestion ` | Reads `GET /api/v1/ingest/{ingestionId}`. `--wait` reads again every 2 seconds until the send completes or fails, for 120 seconds or the `--timeout` you give. | | `recall --identity ` | Asks `POST /api/v1/recall` as that identity and prints the rank, the date and the content of each result. `--limit` and `--max-tokens` bound the page. | ### Where the CLI reads the key The key is not an option of any command, because a key on a command line stays in the shell history. The CLI uses the first key it finds: 1. `PAST_API_KEY` in the environment. 2. A `PAST_API_KEY=` line in `.env.local`, `.env.development.local`, `.env.development` or `.env`, in that order, in the folder you run it in. 3. `apiKey` in `~/.past/config.json`, the file the past.dev plugins for coding agents share. The package is [past-dev on npm](https://www.npmjs.com/package/past-dev).