pelican-cc 0.0.0-stage → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+## 0.2.2
+
+- That a session is also open, idle, in another app is explained once, the first time it
+  happens, and then only in the session menu; the banner no longer sits above the composer of
+  every such session. A session another app is working on still says so plainly.
+- Releases publish to npm from GitHub Actions through npm's trusted publishing, with
+  provenance: no npm token exists, and only the release workflow may publish.
+
+## 0.2.1
+
+The first public release.
+
+- Runs on its own: `npm install -g pelican-cc`, then `pelican`. It listens on `127.0.0.1` and
+  every browser signs in, also on this computer: with the link Pelican prints (an access token,
+  as in Jupyter; `pelican token` prints it again) or with a password (`pelican password`).
+  `--no-auth` is for when a proxy in front already authenticates. Requests must come from
+  Pelican's own page, under a known host name, and no other site may frame it. See
+  [SECURITY.md](SECURITY.md).
+- Images in a reply load only from Pelican; pages and visuals Claude makes cannot reach any server
+  but the public CDNs. A folder Claude has not worked in loads only your user settings when
+  Pelican looks at it, and git does not run there; where Claude has worked, git starts no hooks,
+  file-system monitor, external diff or text converter (your filters, such as Git LFS, run as in
+  your own git). The QR code that opens Pelican on a phone carries a one-time code.
+- `pelican --demo` shows made-up sessions, with nothing of yours involved.
+- Every session's whole history, back past each compaction, with a divider where the context was
+  compacted; older pages load as you scroll up.
+- Three ways to read a session (Summary, Normal, Verbose), and a settings page: theme, the default
+  view, what Enter does, how the session list is grouped and how dense it is, notifications.
+- A menu for each session: rename, branch, export as Markdown, delete, copy the command that
+  continues it in a terminal. Edit an earlier prompt in place, images and all, and send it again:
+  only then does the conversation branch, in one step that leaves nothing behind if it fails.
+- Claude Desktop's side chats are folded out of the list (Settings shows them); background tasks
+  fold into one row when there are several. Archive puts a session away from the list without
+  touching it.
+- A session open in another app too says so; before sending, Pelican catches up with what was
+  said there instead of continuing an older version of the conversation.
+- Editing the last prompt replaces it in place, as rewinding does in Claude Code; an earlier
+  prompt still branches. Model, effort, fast mode and ultracode changed while Claude works apply
+  at once, and a choice not yet used stays with the session.
+- Settings shows the plan's usage as Claude Code's `/usage` does: the 5-hour and weekly windows,
+  or, on Team and Enterprise, the month's extra usage against its cap.
+- `/` commands and `@` files in the composer, ultracode next to effort and fast mode, the task list
+  pinned above the composer, how full the context is, and each turn's time, tokens and cost.
+- Images open full screen. A failed send gives the text back to edit.
+- While Claude works, a message steers it (read at its next step) or waits for the turn: tap the
+  word next to Send. Messages sent mid-turn, from any app, show where Claude read them.
+- `!` commands run in the session's folder; Claude reads the output with the next message.
+- Changes and files: every changed file with its diff, and the folder to browse and mention.
+- Rewind code to before any prompt; open the steps a subagent took; MCP servers with their
+  status; the plan's usage limits; background tasks with Stop; suggested next prompts.
+- Charts and diagrams Claude Desktop draws, pages Claude writes, files it sends, and `html` or
+  `svg` blocks render in place, in a sandboxed frame.
+- Dictation in the composer, and a QR code to open Pelican on your phone.
+- Scrolling up while Claude streams stays where you put it; sending brings the end back into view.
+
+## 0.1.0
+
+A phone-first web app for Claude Code sessions: the session list, live chat with approvals,
+images and files, notifications, and sessions other apps are working on.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shichao Song
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ki-Seki/pelican/main/docs/logo.svg" width="64" height="64" alt="">
+</p>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<h1 align="center">Pelican</h1>
+
+<p align="center">
+  <b>Claude Code, in your pocket.</b><br>
+  A phone-first web app for the Claude Code on your computer. Follow every session live, answer Claude, approve its edits.
+</p>
+
+<p align="center">
+  <a href="https://ki-seki.github.io/pelican/demo/"><b>Live demo</b></a> ·
+  <a href="https://ki-seki.github.io/pelican/">Website</a> ·
+  <a href="https://ki-seki.github.io/pelican/docs.html">Docs</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/pelican-cc"><img src="https://img.shields.io/npm/v/pelican-cc?color=0e7490" alt="npm"></a>
+  <a href="https://github.com/Ki-Seki/pelican/actions/workflows/ci.yml"><img src="https://github.com/Ki-Seki/pelican/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0e7490" alt="MIT license"></a>
+</p>
+
+<a href="https://ki-seki.github.io/pelican/demo/">
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Ki-Seki/pelican/main/docs/shots/phone-dark.png">
+  <img alt="Pelican on a phone: the session list, a session waiting for approval of an edit, and a chart Claude drew" src="https://raw.githubusercontent.com/Ki-Seki/pelican/main/docs/shots/phone-light.png">
+</picture>
+</a>
+
+## Why Pelican
+
+- **Every session, wherever you started it.** The terminal, Claude Desktop, your editor: Pelican
+  reads Claude Code's own transcripts, so every session is there, live while it runs, with its
+  whole history back past each compaction. No wrapper command, no flag to remember.
+- **Nothing in between.** One small process on your computer: no account, no relay server, no copy
+  of your sessions. Reach it over Tailscale, an SSH tunnel or your own proxy.
+- **All of Claude Code.** Approvals with the diff, steer or queue while Claude works, `!` commands,
+  changes and files, rewind code, branches, subagents, MCP servers, usage limits, every model and
+  mode, `/` commands and `@` files. Charts Claude draws and pages it writes render right in the
+  conversation. It runs on the official Agent SDK, so your login, settings, `CLAUDE.md`, skills and
+  MCP servers apply.
+- **Made for a phone.** Calm and quick with one hand. A notification when Claude needs you,
+  dictation, and a Home Screen icon that opens it like an app.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Ki-Seki/pelican/main/docs/shots/tour.gif" width="320" alt="A tour of Pelican on a phone: a chart and a page Claude made, rendered in place; an edit waiting for approval with its diff; a session another app is running">
+</p>
+
+## Quick start
+
+```bash
+npx pelican-cc --demo          # made-up sessions; nothing of yours involved
+npm install -g pelican-cc      # Node 22.12+, with Claude Code signed in
+pelican                        # prints the link that signs you in: http://localhost:7860/?token=…
+```
+
+Then [use it from your phone](https://ki-seki.github.io/pelican/docs.html#phone); with Tailscale it
+takes two commands.
+
+## Docs
+
+[Using Pelican](https://ki-seki.github.io/pelican/docs.html#using) ·
+[configuration](https://ki-seki.github.io/pelican/docs.html#config) ·
+[security](https://ki-seki.github.io/pelican/docs.html#security) ·
+[how it works](https://ki-seki.github.io/pelican/docs.html#how) ·
+[compared with Remote Control, Happy and CloudCLI](https://ki-seki.github.io/pelican/docs.html#compare)
+
+## Contributing
+
+```bash
+npm ci && npm run dev    # the server and the web app, both reloading on change
+npm test && npm run typecheck
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Security reports go through
+[SECURITY.md](SECURITY.md).
+
+## License
+
+[MIT](LICENSE). Pelican is an independent project, not made by or affiliated with Anthropic.