free-pi-cli 0.6.19 → 0.6.21

package/README.md

@@ -19,7 +19,7 @@ npm install -g free-pi-cli
 free-pi-cli
 ```
 
-Requires Node 22.19 or newer. The command is `free-pi-cli`, not `pi`.
+Requires Node 22.19 or newer. The command is `free-pi-cli`, not `pi`. If the built-in agent suggests `pi --session ...` on exit, run `npx free-pi-cli@latest --session <id>` instead (or `free-pi-cli --session <id>` if you installed it globally).
 
 ## Usage
 
@@ -63,6 +63,31 @@ free-pi may use your sessions to improve and train models. See the privacy polic
 
 The agent can read files anywhere your user account can, but it only reads what your request needs. Project settings and extensions in a folder load only after you trust that folder.
 
+## Development
+
+```
+bun install
+bun test          # runs against an in-process stub server; no real network or pi TUI
+bun run typecheck
+bun run build
+```
+
+`FREEPI_BASE_URL` overrides the backend base URL (default `https://api.freepi.ai`), for pointing at a local dev server.
+
+## Repo map
+
+| Path | Purpose |
+|---|---|
+| `src/index.ts`, `src/main.ts` | bin entry and top-level wiring |
+| `src/run.ts` | orchestration: consent, login, token check, launch |
+| `src/auth-flow.ts`, `src/credentials.ts` | sign-in clients; token storage (mode 0600) |
+| `src/consent.ts` | consent screen text and parsing |
+| `src/pi-launch.ts`, `src/provider.ts` | pi SDK integration: registers the free-pi provider and launches the TUI |
+| `src/*-tool.ts`, `src/web-tools.ts`, `src/fusion.ts` | agent tools (images, docs, usage, todo, web) and Fusion model selection |
+| `src/vendor/` | copies of the internal `shared` and `pi-ads` packages |
+| `test/` | tests, one file per source module |
+| `skills/` | bundled agent skills |
+
 ## Links
 
 - Website: https://freepi.ai
@@ -70,3 +95,4 @@ The agent can read files anywhere your user account can, but it only reads what
 - Terms: https://freepi.ai/terms
 - Privacy: https://freepi.ai/privacy
 - Changelog: [CHANGELOG.md](CHANGELOG.md)
+- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md). This repo is a one-way mirror of a private monorepo, and the file explains how pull requests flow back.

package/dist/index.js

@@ -27,4 +27,4 @@ if (err) {
   console.error(err);
   process.exit(1);
 }
-await import("./main-qn3gsj3n.js");
+await import("./main-7sxf1v5b.js");