perchai-cli 2.4.103 → 2.4.105
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -0
- package/dist/perch.mjs +1521 -1289
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# Perch CLI
|
|
2
2
|
|
|
3
|
+
Version 2.4.105 includes the new composer with cursor editing, paste chips,
|
|
4
|
+
history search and external-editor support, plus styled Markdown replies.
|
|
5
|
+
Launch-week Qwen Flash, Qwen Max 0902 and GPT-6.1 Sol selections show `(Promo)`
|
|
6
|
+
until October 13, 2026 at 2:30 p.m. Eastern. Starter gets the two Qwen options;
|
|
7
|
+
Pro promo pins use fair-use allowance first and ask before using Manual usage.
|
|
8
|
+
|
|
3
9
|
Run Perch from a terminal without installing the Desktop app.
|
|
4
10
|
|
|
5
11
|
```sh
|
|
@@ -37,6 +43,29 @@ Run `perch`, then use these commands inside the terminal chat:
|
|
|
37
43
|
- `/delegate <task>` — launch a background delegate (`/bg` alias). Approve/dismiss on Desktop; use `check_delegate` tool in CLI turns.
|
|
38
44
|
- `/flock <task>` — experimental multi-agent mode (hidden; see repo `docs/FLOCK_MODE.md`).
|
|
39
45
|
|
|
46
|
+
## Composer Keys
|
|
47
|
+
|
|
48
|
+
Run `/keys` for the full list. The highlights:
|
|
49
|
+
|
|
50
|
+
- `Enter` sends. `Shift+Enter` (kitty, WezTerm, ghostty), `Alt/Option+Enter`, `Ctrl-J`, or a trailing `\` then `Enter` inserts a new line.
|
|
51
|
+
- `↑`/`↓` move between rows and recall earlier prompts at the edges. `Ctrl-R` searches prompt history.
|
|
52
|
+
- `Ctrl-Z` undoes, `Ctrl-G` opens the draft in `$VISUAL` / `$EDITOR`, `Ctrl-L` clears the screen.
|
|
53
|
+
- `Esc` (or `Ctrl-C`) stops a running turn. On an empty composer, press `Ctrl-C` twice or `Ctrl-D` to exit.
|
|
54
|
+
- Large pastes collapse into a `[Pasted text #N · X lines]` chip; the full text is what gets sent.
|
|
55
|
+
|
|
56
|
+
Prompt history is saved to `~/.perch/cli-history.json` (prompts over 8,000 characters stay in memory only). Environment switches:
|
|
57
|
+
|
|
58
|
+
- `PERCH_CLI_HISTORY=0` keeps history in memory only.
|
|
59
|
+
- `PERCH_CLI_NATIVE_CURSOR=0` paints a block cursor instead of moving the terminal's own cursor.
|
|
60
|
+
- `PERCH_CLI_KITTY_KEYBOARD=0` turns off the kitty keyboard protocol.
|
|
61
|
+
|
|
62
|
+
## Replies
|
|
63
|
+
|
|
64
|
+
Replies render as Markdown in an interactive terminal: headings, bold and italic, lists, quotes, tables, links, and syntax-colored code blocks. Finished paragraphs settle while the rest of the reply streams in. Piped output and `--json` keep the raw text.
|
|
65
|
+
|
|
66
|
+
- `PERCH_CLI_MARKDOWN=0` shows replies as raw text.
|
|
67
|
+
- `PERCH_CLI_HYPERLINKS=1` makes link text clickable (OSC 8) in any terminal; `0` turns it off. By default it is on for iTerm2, WezTerm, kitty, ghostty, Warp, VS Code, Windows Terminal, and recent VTE terminals, and off inside tmux and screen. The URL is always printed next to the link text.
|
|
68
|
+
|
|
40
69
|
## Docs
|
|
41
70
|
|
|
42
71
|
Full CLI architecture and codebase navigation live in the main repo:
|