pelican-cc 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,204 @@
 # Changelog
 
+## 0.4.0
+
+Files, changes and side chats as in Claude Desktop, workflows and `!` commands you can watch, and
+your usage from every app.
+
+### Highlights
+
+- **Changes and files.** See what each turn changed (T1, T2…, numbered and counted as Claude
+  Code's `/diff` does until a compaction, from its own record, so also outside git), what is
+  uncommitted, or everything since your branch split from main, with diffs, and Rewind code where
+  Claude Code kept a checkpoint. Search the folder by name or in the text, and read a file with
+  line numbers, Markdown and HTML previewed. A file a step names, or a `path:line` in a reply,
+  opens at its line, and under a turn that edited files "3 files changed" opens them. On a phone
+  it is a view of its own that the back gesture steps through; on a computer it sits beside the
+  conversation from 1024px wide.
+- **Side chats.** `/btw`, Cmd/Ctrl+; or Side chat in the session menu asks something on the side,
+  as in Claude Desktop. Claude answers from a read-only copy of the session (Read, Grep and Glob,
+  no MCP servers, never Bypass), and is told so with each question, as in Desktop. Nothing goes
+  back to the session, which keeps working. It sits beside the conversation from 1024px wide,
+  taking turns with Changes and files, and is a sheet on a phone. Side chats are Claude Code
+  sessions titled "Side chat", kept out of the session list (List options > Side chats shows them),
+  and continue in the CLI and Desktop; opened from the list, one keeps its box for questions only.
+- **Quote.** Select text in a reply, a step's output or a file and tap Quote. The quote waits
+  above the message box with your draft and goes above your words as a `>` quote; lines of a file
+  carry where they are, as `src/app.ts:7-8`.
+- **Live `!` commands.** Output as it comes, with Stop, for up to 30 minutes. When a command ends,
+  Claude answers it, as in the CLI, unless `respondToBashCommands` is false. Commands are written
+  the way Claude Code writes them, so the terminal and Desktop show Pelican's, and Pelican shows
+  theirs.
+- **Usage and activity.** Settings > Usage and activity shows your Claude Code usage on this
+  computer, from every app: tokens of each kind over 7 days, 30 days or all time, per day,
+  sessions, active days and streaks, and where they went by project, model, app and session, with
+  a few highlights. On a plan its limits are at the top; on an API key or a provider, the cost
+  Claude Code estimates. Each reply counts once, also when it was copied into a side chat or a
+  branch; Claude Code's `/stats` counts each content block, so its totals are higher. The session
+  menu shows what that session used.
+- **Workflows.** A workflow (Claude Code's Workflow tool) shows as a card, as Claude Code shows
+  one, instead of its script's first line: its name, Running or how it ended with its agents and
+  tokens, its phases one a line (Review · 3 of 5 done) opening into their agents and each agent's
+  steps, the script and the result. It is live, with Stop, in sessions Pelican runs, and read from
+  the run's folder for other apps'; its end, also one that came while Claude worked (those were
+  lost), leads back to the card. Asked to run one, the approval shows its phases, the args its
+  script runs with and the file it runs.
+
+### Changes in behavior
+
+- Line comments go with your next message in the session they were written in, before your words,
+  as in Claude Desktop, or on their own with Cmd/Ctrl+Enter, instead of Add to message. They are
+  kept across reloads and forgotten on sign-out.
+- Transcript views are Claude Desktop's: Normal, Thinking and Verbose, and Ctrl+O steps through
+  them. Thinking shows in a session's menu once Claude has thought there. A session set to Summary
+  opens in Normal.
+- A `!` command may run 30 minutes instead of two, and Claude answers it when it ends, which is a
+  turn like a prompt. A command you stop gets no answer, and one still running when Pelican stops
+  gets up to 15 seconds to tidy up, then ends with it; Ctrl+C again ends it at once. Under launchd
+  it gets what the login item leaves: `pelican service install` now asks launchd for 20 seconds,
+  where it gave 5.
+- Claude gets a `!` command's output as Claude Code's bash mode gives it, in the record Claude
+  Code writes for the same output: stdout and stderr together in the order they were written, as
+  much as Claude Code reads back of it, 30,000 bytes or what `bashOutputMaxChars` sets (where that
+  is unset, BASH_MAX_OUTPUT_LENGTH, 1 to 150,000), instead of up to 200,000 characters of each. A
+  failed one is cut there. One that went well and printed more is saved in the session's
+  `tool-results` folder, where Claude Code saves one, up to 64MB, and Claude gets its start and
+  where it is; so is one whose text is longer than Claude gets inline (30,000 characters, or what
+  `bashOutputMaxChars` sets). Exit code 1 from grep, diff, test or find is an answer, not a
+  failure, when that command is the line's last statement as Claude Code's parser reads it (not
+  in a subshell or a `{ }` group; a comment is none). The record no longer adds the exit code, or
+  that something runs on in the background, as Claude Code's adds neither.
+- What Claude changes in answer to a `!` command is that command's turn in Changes, as in `/diff`;
+  a message of files alone starts a turn, a picture sent without words none, and a new file's
+  lines count as `/diff` counts them. After a compaction `/diff` numbers from 1 again, and it reads
+  only the last 4,096 messages, so in a longer stretch its T1 is a later turn; Pelican, which shows
+  every turn, counts on from the first.
+- A renamed file's diff shows the rename and what changed in it, instead of the whole file as new;
+  one renamed whole says "Renamed from …, unchanged".
+- Push and Create PR, on the branch line, show only where the repository has a remote with an
+  address, not one that only a system or managed git config names (a fetch line for every
+  repository).
+- Changes and files docks from 1024px wide instead of 1440px; below 1280px the session list folds
+  away while it is open, and Cmd/Ctrl+K brings it back.
+- Cmd/Ctrl+\ closes Changes and files when pressed in it, as it closes the side chat and as Close
+  pane does in Claude Desktop; closed, the pane gives the keys to the button that opens it.
+- The keyboard shortcuts (Cmd/Ctrl+/) list Changes and files (Cmd/Ctrl+Shift+D), Close pane
+  (Cmd/Ctrl+\) and Send comments (Cmd/Ctrl+Enter), and call Ctrl+O Transcript view.
+- Commit, Push and Create PR, on the branch line, put a request to Claude in the message box, so
+  your rules, hooks and attribution apply. Pelican runs no git that changes anything.
+
+### Sessions and the list
+
+- Claude Desktop's side chats stay out of the list also once Claude Code has given them the
+  session's title again, as it does when their Claude exits; most showed as more sessions with
+  that title.
+
+### The conversation
+
+- An approval says Claude's few words on a command once, also when Claude Code passes them as its
+  own line too.
+- A failed request at the end of the conversation offers Retry, which sends the prompt again with
+  its files, or Compact when the conversation is too long.
+- Scheduled check-ins have Cancel, which asks Claude to cancel them.
+- An MCP server that needs you to sign in says where: `claude mcp login <name>` in a terminal on
+  the computer, or claude.ai's connectors page.
+- Approval notifications have Allow and Deny where the device shows buttons on notifications
+  (Chrome on a computer or Android), for a command a notification shows whole: printable ASCII with
+  one space between words, on one line, short enough for two lines of the narrowest notification
+  (about 50 characters, fewer when they are wide), and on Android, whose pop-up shows one line
+  beside the buttons, for that one line (about 20). A notification shows the command itself, not
+  Claude's description of it; edits, other tools, other commands, questions and plans open the
+  session.
+- Notifications and check-ins keep emoji whole, also those made of several pictures, and still
+  leave out characters that hide text or turn it around, now also from a notification's title, the
+  session's. Their text is cut between characters as they show, and sooner where those hold many
+  code points (one letter can carry any number of accents), so a notification stays within the
+  4 KB a push service carries.
+- Export as Markdown has the conversation as it shows here: `!` and `/` commands as typed, as
+  code, with their output; the files and pictures sent with a prompt; Claude Code's own lines,
+  such as a background task's note, Interrupted, a failed request (naming the computer, as the
+  conversation does) or a hook's word, and a command that failed marked so; and none of
+  the tags, notes and summaries Claude Code and Pelican add for Claude, such as a side chat's note
+  with each question.
+- The session menu shows the session's tokens, the share from the cache, its models and
+  compactions, and its cost where Claude Code counts one.
+- A finished `!` command shows the end of its output, as it did while it ran; Show all shows the
+  start, and for one too long for the conversation what Claude Code saved of it (up to 64MB), from
+  that file, a page at a time, also in a branch that copied it. One that printed nothing shows the
+  command alone, and one that failed says Failed, or Stopped, where its live card said how it
+  ended; a record from before (Claude Code before 2.1.80, Pelican before 0.4) says so only where
+  it noted it. A running one's Stop is named for it.
+- Claude's answer to a background task's note shows after the note, not in the reply before it.
+- A message that does not go comes back to the message box, files and all, above anything typed
+  since. A `!` or `/` command comes back only into an empty box; with words or files there, it
+  waits above the box, Not sent, with Put back, as does a message, files and all, that comes back
+  while a command is typed. A `/` command goes with its words alone: files in the box wait for the
+  next message, as quotes do. What waits stays across reloads, and in a new session goes on with
+  the session once it starts, line comments too. Put back brings words and files back together, or, where they cannot
+  share the box, swaps them with what is there, which waits in its place, Set aside. One sent for
+  you (Send now, Compact, Retry, Cancel) leaves the box as it is.
+- A path or "files changed" tapped while the side chat is open puts it away and opens Changes and
+  files.
+- Side chat in the session menu leaves the keys in the side chat's box, which, beside the
+  conversation on a tablet, keeps clear of the home indicator, level with the conversation's.
+  Quotes that do not fit above the message box fade at its edge, and removing one with the
+  keyboard moves on to the next.
+- A conversation opens without the code of Changes and files, which follows once it is up, and
+  Settings without the usage page.
+
+### Changes and files
+
+- Search in files shows each hit where it is on its line, after a "…" when it is far along,
+  marked in amber.
+- A file's Quote and Copy sit in a row of their own under the file, so nothing scrolls beneath
+  them.
+- On a touch screen, search results and a step's file name are a finger tall, and the lowest row
+  of Changes and files (Quote and Copy, Send now, or the bar saying Claude needs you) keeps clear
+  of the home indicator, on a phone and beside the conversation on a tablet.
+- Esc in a comment on a file gives the keys back to the file, as on a diff, so the next Esc closes
+  the view.
+
+### Security
+
+- In a folder kept to your settings only, a `!` command runs git as Claude Code does there, with
+  none of the repository's own programs (its file-system monitor, filters or hooks folder).
+- Changes and files reads only regular files inside the folder it is asked about (the session's),
+  links followed and checked. Downloads come as inert attachments. Search runs the ripgrep inside
+  Claude Code with no config, an empty environment, no git and no links followed.
+- Show all on a long `!` command reads the file Claude Code saved its output in by that file's
+  name alone, from the session's own `tool-results` folder, or, for a record a branch copied, from
+  that of the session its row says it came from, when the record's path names that session: a
+  regular file reached through no link and with no other name.
+- A page in Files runs its scripts only after Run, and again only after another Run once it has
+  been rewritten; a page opened straight from another file never starts running.
+- A side chat only reads, asks for nothing, and takes no `/` or `!` commands. A side chat branched
+  from one of its questions is one too.
+- Notification buttons go through the same checks as the page, and Allow is offered only for a
+  command a notification shows in full: printable ASCII with one space between words, on one line,
+  that fits two lines of the narrowest notification in its widest letters, and on Android, whose
+  pop-up shows one line beside the buttons, that one line.
+
+### Site, docs and project
+
+- The demo's files have their text, and the files its conversations name open at the lines they
+  name.
+- The docs cover Changes and files, side chats, quotes, live `!` commands, the views and the
+  usage page, and the coverage table moves side questions, views, quotes and Create PR to Yes.
+- On a phone, the website leads with the two buttons and the install command, then shows the app
+  in the same phone frame as on a computer, whole when you scroll, instead of a cropped card.
+- The browser smoke test checks the docked pane at 1024, 1280 and 1440px and the side chat pane at
+  1024px, where it asks a question, and opens older sessions at one size only, to keep CI quick.
+
+## 0.3.1
+
+- New sessions start at High effort until you pick another in Settings (New sessions start with >
+  Model); picking Default there leaves the effort to Claude Code, as before. Sessions that already
+  ran keep what they ran with, and a model without effort levels gets none.
+- On a computer, Changes and files docked beside the conversation is no longer cut off at the
+  right edge when the conversation holds long lines (the column grew to fit them).
+- The website's phone pictures show the whole screen, the message box included.
+- qrcode-generator 2 and esbuild 0.28 (the QR codes are the same, checked bit for bit).
+
 ## 0.3.0
 
 Every Claude Code session on your computer, on your phone. This release follows a ten-angle audit

package/README.md

@@ -66,12 +66,15 @@ The docs cover [an SSH tunnel or your own proxy](https://ki-seki.github.io/pelic
   every compaction. When another app is working on one, or waits for you there, Pelican says which
   app; once it is idle, continue it here.
 - **All of Claude Code.** Approvals with the diff, plans and questions, steer or queue while Claude
-  works, `!` commands, `/` commands and skills, `@` files, every model and permission mode, rewind
-  and branch, subagents and background tasks, MCP servers and usage limits.
+  works, side chats, `!` commands with their output live, `/` commands and skills, `@` files, every
+  model and permission mode, rewind and branch, subagents and background tasks, MCP servers.
 - **What Claude makes, in place.** Charts and diagrams Claude draws and pages it writes show in the
   conversation, as still pictures until you tap Run.
-- **The changes beside the chat.** Every changed file with its diff. Tap a line to comment, and
-  your comments go into the next message.
+- **Changes and files, as in Claude Desktop.** What each turn changed, what is uncommitted, or
+  everything since your branch split, with diffs. Search and read the folder; a path in a reply
+  opens the file at its line. Comment on a line or quote it, and Create PR asks Claude.
+- **Your usage, from every app.** Tokens, sessions and streaks by project, model and app, with your
+  plan's limits, or the cost Claude Code estimates on an API key.
 - **Made for a phone, good on a computer.** One hand, dictation, a notification when Claude needs
   you or finishes, and a Home Screen icon. On a wide screen, the list, the conversation and the
   changes sit side by side.
@@ -101,8 +104,7 @@ Remote Control can answer a prompt waiting in your terminal; Pelican cannot. Mor
 Pelican runs Claude Code itself, so your settings, `CLAUDE.md`, hooks, skills, subagents and MCP
 servers work as they do in the terminal, and so does any login: a Claude plan, an API key, Bedrock,
 Google Cloud or Microsoft Foundry. What Pelican does not do: Remote Control, cloud sessions, a
-worktree for each new session, side questions (`/btw`), a terminal of its own, or editing files by
-hand. [The full table](https://ki-seki.github.io/pelican/docs.html#coverage) goes through Claude
+worktree for each new session, a terminal of its own, or editing files by hand. [The full table](https://ki-seki.github.io/pelican/docs.html#coverage) goes through Claude
 Code's features one by one.
 
 ## Security