promptarc 0.0.3 → 0.0.4

package/README.md

@@ -1,45 +1,53 @@
 # promptarc
 
-> Local-first viewer for AI coding agent sessions. Browse, search, and share your Claude Code, Codex, and Cursor sessions — without uploading anything you didn't ask to.
+> See what your AI coding agent actually did. Browse, search, share, and generate PR descriptions from Claude Code, Codex, and Cursor sessions.
 
 ```bash
 npx promptarc
 ```
 
-That's it. The CLI boots a dashboard at `http://localhost:3030` that reads `~/.claude/`, `~/.codex/`, and `~/.cursor/` — rendering every session from Claude Code, OpenAI Codex, and Cursor as an inspectable timeline (messages, tool calls, file diffs, todos, errors, the works).
-
-## Features
-
-- **Multi-agent.** Reads `~/.claude/` (Claude Code), `~/.codex/` (Codex), and `~/.cursor/` (Cursor) in one dashboard with tabs to filter by agent.
-- **Live updates.** Open a session that's still running and the page refreshes within ~300ms of every new message Claude writes.
-- **Resume.** Lost track of which session you were on? Click any session and copy the `claude --resume <id>` command from the sidebar.
-- **Selective sharing.** Click *Share session* to upload a single session as a viewable link. Choose visibility per share: **public** (indexed), **unlisted** (anyone with the URL), or **private** (only you, default).
-- **Cloud sync.** Optionally back up new sessions for a project to your account so you can browse them from anywhere — always private until you say otherwise.
-- **Redaction.** Secrets, home-directory paths, base64 blobs, and AI thinking blocks are stripped before any upload. The redaction pipeline is open source and auditable.
-- **Account-bound.** Sign in once with `promptarc login` (GitHub OAuth via [promptarc.dev](https://promptarc.dev)) and your shares are tied to your account, manageable from the web.
+Every command works standalone from the terminal. The dashboard is optional for visual browsing.
 
 ## Commands
 
 ```text
-promptarc            Boot the dashboard at http://localhost:3030
-promptarc login      Sign in to your promptarc account via GitHub
-promptarc logout     Delete the saved auth token
-promptarc whoami     Print the currently signed-in account
-promptarc --version  Print the CLI version
-promptarc --help     Show usage
+npx promptarc                  Open the visual dashboard
+npx promptarc context          What do I need to know? Past sessions + AI briefing
+npx promptarc context --files  Include recently changed files in the search
+npx promptarc share <id>       Share a session to the cloud (private, no dashboard needed)
+npx promptarc pr               Generate a PR description from the current session
+npx promptarc pr --share       Generate + share session (includes link in description)
+npx promptarc pr --copy        Generate + copy to clipboard
+npx promptarc pull <slug>      Download a shared session to this machine for resume
+npx promptarc login            Sign in via GitHub (auto-triggered when needed)
+npx promptarc logout           Delete the saved auth token
+npx promptarc whoami           Print the signed-in account
+npx promptarc --version        Print the CLI version
 ```
 
-## Privacy model
+## What it does
+
+- **Session prep.** `promptarc context` scans your local sessions + cloud archive and generates an AI briefing with what's unfinished, a copy-pasteable resume prompt, and warnings from past failures.
+- **Share from terminal.** `promptarc share <id>` builds the artifact locally, redacts secrets, and uploads directly. No dashboard needed. Auto-signs in if needed.
+- **PR descriptions.** `promptarc pr` generates structured PR descriptions (What / Why / How / Notes) from your session. Pipe to `gh pr create`.
+- **Multi-agent.** Reads `~/.claude/` (Claude Code), `~/.codex/` (Codex), and `~/.cursor/` (Cursor) in one dashboard with tabs.
+- **Live updates.** Open a running session and it refreshes within ~300ms of every new message.
+- **Cloud sync.** Back up sessions to your account. Search across your history from any machine.
+- **AI summaries.** Every shared session gets an AI-generated summary, searchable via full-text search.
+- **Redaction.** Secrets, API keys, home-directory paths, and thinking blocks are stripped before any upload.
+- **Private by default.** New shares are private. You promote to public/unlisted when ready.
+
+## Privacy
 
-- The dashboard server binds to **127.0.0.1 only**. Nothing on your LAN can reach it.
-- The CLI never uploads anything by default. Sharing is opt-in *per session*; cloud sync is opt-in *per project*.
-- New shares default to **private**. You promote to public/unlisted from the share modal.
-- The auth token (saved at `~/.promptarc/auth.json`, mode 0600) is never sent to anything except `promptarc.dev`.
+- The dashboard binds to **127.0.0.1 only**. Nothing on your LAN can reach it.
+- `promptarc share` redacts secrets **locally** before uploading. Raw session data never leaves your machine.
+- `promptarc pr` sends only a condensed summary (~2K tokens) to the server. No code content, no secrets.
+- The auth token (`~/.promptarc/auth.json`, mode 0600) is only sent to `promptarc.dev`.
 
 ## Requirements
 
-- Node.js ≥ 20
-- At least one of: `~/.claude/` (Claude Code), `~/.codex/` (Codex), or `~/.cursor/` (Cursor)
+- Node.js 20+
+- At least one of: `~/.claude/`, `~/.codex/`, or `~/.cursor/`
 
 ## Feedback