{"id":"inbox","repo":"koinzhang/paseo-plugins","url":"https://github.com/koinzhang/paseo-plugins/tree/main/inbox","package":"@koinzhang/paseo-plugin-inbox","npm":{"package":"@koinzhang/paseo-plugin-inbox","version":"0.1.0","integrity":"sha512-W1lHL5bdHqrZBey64v16Am1LxyvqB1VvONeNt0CYQlDE010MJ1O3dUexDyimu2Wv24xs6tVRNUjI2HdkkhXpQg==","publishedAt":"2026-09-30T16:05:17.573Z","downloadsLast30Days":0},"name":"inbox","description":"Personal inbox for Paseo: star agents, keep notes per project, and capture scratch text.","categories":["productivity"],"platforms":[],"caveats":["Requires Paseo 0.9.0 or later.","Password-protected local daemons require PASEO_PASSWORD to unarchive agents."],"images":["https://raw.githubusercontent.com/koinzhang/paseo-plugins/b852d42e5acdfc643091f65d2c1564c0e78f22df/inbox/images/inbox-1.png","https://raw.githubusercontent.com/koinzhang/paseo-plugins/b852d42e5acdfc643091f65d2c1564c0e78f22df/inbox/images/inbox-2.png","https://raw.githubusercontent.com/koinzhang/paseo-plugins/b852d42e5acdfc643091f65d2c1564c0e78f22df/inbox/images/inbox-3.png"],"themes":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":true,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-30T18:05:09.185Z","addedAt":"2026-09-30T21:01:13+03:00","npmSecurity":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-30T18:04:56.068Z","version":"0.1.0","integrity":"sha512-W1lHL5bdHqrZBey64v16Am1LxyvqB1VvONeNt0CYQlDE010MJ1O3dUexDyimu2Wv24xs6tVRNUjI2HdkkhXpQg=="},"path":"inbox","version":"0.1.0","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-30T18:04:56.068Z","commit":"b852d42e5acdfc643091f65d2c1564c0e78f22df"},"license":"MIT","paseoVersionRequirement":">=0.9.0","descriptionNodes":[{"type":"text","text":"Personal inbox for Paseo: star agents, keep notes per project, and capture scratch text."}],"caveatNodes":[[{"type":"text","text":"Requires Paseo 0.9.0 or later."}],[{"type":"text","text":"Password-protected local daemons require PASEO_PASSWORD to unarchive agents."}]],"manifest":{"id":"inbox","description":"Personal inbox: starred agents, notes, project records, and quick scratch captures","requirements":{"paseo":">=0.9.0"}},"repoMeta":{"stars":6,"defaultBranch":"main","pushedAt":"2026-09-30T15:59:51Z"},"owner":{"login":"koinzhang","avatarUrl":"https://avatars.githubusercontent.com/u/36128970?v=4"},"installNotesHtml":"<pre><code class=\"language-bash\">paseo plugin add npm:@koinzhang/paseo-plugin-inbox\n</code></pre>\n<p>To install from GitHub, use <code>paseo plugin add koinzhang/paseo-plugins --path inbox</code>.</p>","readmeText":"# Inbox\n\nA personal inbox for Paseo: star agents, keep notes per project, and capture scratch text without leaving the composer.\n\n- **Starred agents**: ⌘K → *Add agent to Inbox*. A starred agent stays in the Inbox after it is archived; *Unarchive* restores it, restoring its archived workspace first when needed. Its detail shows the latest user prompt and the latest agent reply.\n- **Notes**: ⌘K → *New Inbox note*, or *+ Note* in the Inbox. Autosaved plain text / Markdown.\n- **Scratch**: type `/inbox <text>` in an agent composer. It is tagged with the current project. Nothing is sent to the agent. Convert scratch to a note later.\n- **Star from the composer**: type `/inbox` with no text to add the current agent to the Inbox.\n- **Tags**: every item can carry a project tag and a workspace tag. On a note or scratch, tap the tags in its detail to change them. A workspace must belong to the tagged project: while a workspace is set, other projects are unavailable, and picking a workspace alone sets its project. A starred agent is tagged with its own workspace and project.\n- **Workspace Inbox**: the *Inbox* panel in the right-hand Explorer shows items tagged with that workspace, plus items tagged only with its project. It is a filtered view of the one Inbox, so everything in it is also on the Inbox page. A note added in the panel is tagged with that workspace. An Inbox icon in the workspace header opens it, and hides while the panel is open. The note and add-agent buttons sit to the right of search. Workspace and project chips on the Inbox page appear only on the *Agents* tab; tap one to narrow the agents, tap again to clear. The choice is kept when you leave Agents and applied again when you come back.\n- **Archived projects and workspaces**: their items stay in the Inbox; their tags and chips are struck through, and the strike goes away when they are restored.\n- **Sorting**: the button next to *+ Note* on the Inbox page cycles through updated time (default), starred time, created time, and name. Drag the divider to resize the list. Pinned items stay on top.\n- **Projects**: items are grouped by the git remote URL (`origin`, else the first remote), falling back to the repository root, then the directory. Worktrees of one repository share a project.\n- **Hosts**: data lives on each daemon in `~/.paseo/plugin-data/inbox/inbox.db`. With several hosts connected, the Inbox host picker switches between them.\n\nRequires Paseo >= 0.9.0 and a daemon Node runtime with `node:sqlite`.\n\n## Install\n\n```bash\npaseo plugin add npm:@koinzhang/paseo-plugin-inbox\n```\n\nTo install from GitHub, use `paseo plugin add koinzhang/paseo-plugins --path inbox`.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\nnpm test\npaseo plugin install \"$PWD\"\npaseo plugin reload inbox\n```\n\nSpecs: [`specs/`](./specs/).\n"}