pi-anchor 0.6.0 → 0.6.1

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.
Files changed (4) hide show
  1. package/README.md +11 -10
  2. package/README_zh.md +12 -11
  3. package/package.json +1 -1
  4. package/README_ja.md +0 -90
package/README.md CHANGED
@@ -1,15 +1,15 @@
1
1
  # ⌖ Anchor
2
2
 
3
- > **A digital sticky note docked below your Pi editor — 0ms instant stick, micro progress bars `[■■□□ 2/4]`, 1-click session teleport (`↪`), and automatic teardown on `git commit`.**
3
+ > **A digital sticky note & cross-session `todo` checkpoint docked below your Pi editor — automatically catches unfinished `todo` lists when you close the terminal, sticks quick notes in 0ms (`pin: ...`), and teleports back to the original session (`/back`).**
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/pi-anchor?color=blue)](https://www.npmjs.com/package/pi-anchor)
6
6
  [![npm downloads](https://img.shields.io/npm/dm/pi-anchor?color=22c55e&label=downloads)](https://www.npmjs.com/package/pi-anchor)
7
7
  [![GitHub stars](https://img.shields.io/github/stars/3ZEROS12/anchor?style=flat&color=f59e0b)](https://github.com/3ZEROS12/anchor/stargazers)
8
8
  [![CI Status](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml/badge.svg)](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml)
9
- [![Tests: 10 Passed](https://img.shields.io/badge/Tests-10%20Passed-22c55e.svg)](tests/store.test.ts)
9
+ [![Tests: 11 Passed](https://img.shields.io/badge/Tests-11%20Passed-22c55e.svg)](tests/store.test.ts)
10
10
  [![License: MIT](https://img.shields.io/badge/License-MIT-f97316.svg)](LICENSE)
11
11
 
12
- **English** | [日本語](./README_ja.md) | [简体中文](./README_zh.md)
12
+ **English** | [简体中文](./README_zh.md)
13
13
 
14
14
  ```bash
15
15
  pi install npm:pi-anchor
@@ -37,11 +37,11 @@ Late at night, mid-way through fixing a bug, you spot a second issue in `src/aut
37
37
  2. **`TODO.md` Pollutes Git & Burns Context Tokens**: Tracking personal reminders inside repository markdown files dirties `git status` and re-injects stale checklists into the system prompt on every turn.
38
38
  3. **Splash Banners Vanish When You Start Typing**: Traditional startup widgets disappear on the first message. For the rest of a two-hour session, your notes are hidden unless you manually run a slash command.
39
39
 
40
- **Anchor acts like a physical sticky note stuck to the bottom bezel of your Pi editor**:
41
- - **Persistent Below-Editor Strip (`belowEditor`)**: Docks a single-line note strip directly beneath your input box. It stays in view while you code, leaves `aboveEditor` untouched for extensions like `pi-lingual`, and collapses to 0 lines when empty.
40
+ **Anchor acts like a physical sticky note and auto-save checkpoint stuck to the bottom bezel of your Pi editor**:
41
+ - **Auto-Todo Bridge (`todo` ➔ Cross-Session Checkpoint)**: Standard `todo` tools (`@juicesharp/rpiv-todo` and built-in `todo`) live only inside a single conversation with zero disk writes — closing the terminal or running `/new` wipes unfinished tasks. Anchor automatically mirrors unfinished `todo` snapshots to disk (`[■■□□ 2/5]`) and auto-clears them the moment all steps reach `completed`.
42
+ - **Persistent Below-Editor Strip (`belowEditor`)**: Docks a single-line note strip directly beneath your input box. It stays in view while you code, leaves `aboveEditor` untouched for extensions like `pi-lingual` and `rpiv-todo`, and collapses to 0 lines when empty.
42
43
  - **0ms Human-First Capture (`pin: ...`)**: Type `pin: Check token expiry` (or `/pin ...`) straight into the editor. An input hook intercepts the text in `0.00ms` without calling the language model or spending tokens.
43
- - **Micro Progress Bar (`[■■□□ 2/4]`)**: Write `[2/4]` or numbered steps (`1. Extract interface 2. HttpOnly cookie 3. Unit tests`) in your note to get an inline 4-cell progress bar with next-step hints.
44
- - **Session Teleport (`↪ Jump to session`)**: Every note bookmarks the exact `.jsonl` session file where it was created or last touched. Select `↪ Jump to session` in `/anchor` to switch Pi straight back to that conversation.
44
+ - **Session Teleport (`/back` & `↪ Jump to session`)**: Every note and auto-checkpoint bookmarks the exact `.jsonl` session file where work happened. Run `/back` (or select `↪ Jump to session` in `/anchor`) to switch Pi straight back to that conversation.
45
45
 
46
46
  ---
47
47
 
@@ -49,9 +49,10 @@ Late at night, mid-way through fixing a bug, you spot a second issue in `src/aut
49
49
 
50
50
  | Mode / Action | What You Input | What the Engine Does | What You See | Best For |
51
51
  | :--- | :--- | :--- | :--- | :--- |
52
+ | **Auto-Todo Checkpoint** | Agent calls `todo` (`2/5` done, then you quit or `/new`) | Mirrors unfinished `todo` snapshot + modified files + `sessionFile`; auto-clears at `5/5` | Next session shows: `⌖ #1 [■■□□ 2/5] Switch token ▸ Add tests (↪)` | Never losing unfinished `todo` lists across terminal restarts |
52
53
  | **Stick a Note (0ms)** | Type `pin: Fix auth in src/auth.ts` or `/pin ...` | Intercepts via input hook in `0ms`, extracts file paths, and links current `sessionFile` | 1-line strip appears below editor: `⌖ #1 Fix auth (app · auth.ts ↪)` | Capturing a tangent without derailing the current prompt |
53
54
  | **Track Multi-Step Work** | Type `/pin Refactor: 1. API 2. Cookie 3. Tests` then `/step 1` | Parses step list and increments `done / total` counter in `~/.anchor/state.json` | Strip updates in place: `⌖ #1 [■■□□ 2/3] Refactor ▸ Tests` | Multi-session features and long-running study goals |
54
- | **Resume Context (`↪`)** | Run `/anchor` ➔ select `↪ Jump to session` (or `/anchor jump 1`) | Invokes Pi's native `ctx.switchSession(note.sessionFile)` | Terminal switches directly back to the original conversation transcript | Picking up a complex task days later with full history |
55
+ | **Resume Context (`/back`)** | Run `/back` (or `/anchor` ➔ `↪ Jump to session`) | Invokes Pi's native `ctx.switchSession(note.sessionFile)` | Terminal switches directly back to the original conversation transcript | Picking up a complex task days later with full history |
55
56
  | **Auto-Tear on Commit** | Commit code (`git commit -m "feat: fix auth"`) or run `/done 1` | Matches commit message against active notes (filtering generic stop-words) | Note archives to `archive.jsonl`; strip clears (`⌖ Auto-torn off #1`) | Keeping the sticky strip clean without manual bookkeeping |
56
57
 
57
58
  ---
@@ -90,7 +91,7 @@ All state lives in `~/.anchor/` outside your git repository:
90
91
  | **Pi Slash** | `/pin <note>` | Stick a note (supports `[1/4]` or `1. A 2. B 3. C` steps) |
91
92
  | **Pi Slash** | `/anchor` | Open interactive sticky note board (tear off, `+1` step, `↪` jump to session, or read details) |
92
93
  | **Pi Slash** | `/step 1` | Advance progress bar on note `#1` by `+1` |
93
- | **Pi Slash** | `/anchor jump 1` | Switch Pi back to the conversation session linked to note `#1` |
94
+ | **Pi Slash** | `/back` (or `/anchor jump 1`) | Teleport Pi back to the conversation session of the latest unfinished note/todo checkpoint |
94
95
  | **Pi Slash** | `/done 1` / `/anchor 1` | Tear off note `#1` and archive it |
95
96
  | **Pi Slash** | `/anchor undo` | Put back the most recently torn-off note |
96
97
  | **Terminal CLI** | `anchor` / `anchor "<note>"` | View or stick notes from any shell outside Pi |
@@ -111,7 +112,7 @@ In `v0.4` and `v0.5`, I threw away 60% of the codebase and rebuilt Anchor around
111
112
 
112
113
  ```bash
113
114
  npm run typecheck # Strict tsc --noEmit check (0 errors)
114
- npm test # Native Node test runner (10/10 passing)
115
+ npm test # Native Node test runner (11/11 passing)
115
116
  npm run build # Dual ESM/CJS compilation via tsup + declaration emit
116
117
  ```
117
118
 
package/README_zh.md CHANGED
@@ -1,15 +1,15 @@
1
1
  # ⌖ Anchor
2
2
 
3
- > **贴在 Pi 输入框正下方的电子便签 —— `便签: ...` 0ms 瞬贴上屏、长线任务迷你进度条 `[■■□□ 2/4]`、一键切回原对话上下文 (`↪`)，`git commit` 提交代码自动撕便签。**
3
+ > **贴在 Pi 输入框正下方的跨会话电子便签与 `todo` 自动存档点 —— 关终端自动接管未完 `todo` 进度 `[■■□□ 2/5]`，敲 `便签: ...` 0ms 瞬贴支线灵感，敲 `/back` 一键穿越回原对话，`git commit` 自动撕便签。**
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/pi-anchor?color=blue)](https://www.npmjs.com/package/pi-anchor)
6
6
  [![npm downloads](https://img.shields.io/npm/dm/pi-anchor?color=22c55e&label=downloads)](https://www.npmjs.com/package/pi-anchor)
7
7
  [![GitHub stars](https://img.shields.io/github/stars/3ZEROS12/anchor?style=flat&color=f59e0b)](https://github.com/3ZEROS12/anchor/stargazers)
8
8
  [![CI 状态](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml/badge.svg)](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml)
9
- [![Tests: 10 Passed](https://img.shields.io/badge/Tests-10%20通过-22c55e.svg)](tests/store.test.ts)
9
+ [![Tests: 11 Passed](https://img.shields.io/badge/Tests-11%20通过-22c55e.svg)](tests/store.test.ts)
10
10
  [![开源协议: MIT](https://img.shields.io/badge/开源协议-MIT-f97316.svg)](LICENSE)
11
11
 
12
- [English](./README.md) | [日本語](./README_ja.md) | **简体中文**
12
+ [English](./README.md) | **简体中文**
13
13
 
14
14
  ```bash
15
15
  pi install npm:pi-anchor
@@ -37,11 +37,11 @@ pi install npm:pi-anchor
37
37
  2. **`TODO.md` 弄脏 Git 且每轮白烧 Token**：在项目根目录维护待办文件，既制造杂乱的 Git 修改记录，又在每一轮对话里反复把旧清单塞进系统提示词。
38
38
  3. **开局闪现横幅一打字就消失**：普通插件只在打开终端时闪一下提示，你发完第一句话它就自我隐藏。接下来两个小时写代码，除非专门敲命令查询，否则根本看不见自己记了什么。
39
39
 
40
- **Anchor 的定位很单纯：贴在 Pi 输入框下边框的一张电子便签**：
41
- - **输入框正下方常驻 1 行 (`belowEditor`)**：便签条固定在输入框下沿，写代码时抬眼可见；输入框上方空间完全留给 `pi-lingual` 等插件；没有便签时自动收起为 0 行。
42
- - **自己随手敲，0ms 瞬贴 (`便签: ...`)**：直接在输入框敲 `便签: 检查网关超时重试`（或 `pin: ...`、`/pin ...`），输入钩子在 `0.00ms` 内直接拦截上屏，不调用大模型、不耗费 1 个 Token，并自动关联当前刚修改过的代码文件。
43
- - **长线任务迷你进度条 (`[■■□□ 2/4]`)**：在便签里写 `[2/4]` 或分步序号 `1. 抽出接口 2. 替换Cookie 3. 补单测`，便签条自动显示 4 格进度条与下一步提示。
44
- - **原对话一键穿越 (`↪ Jump to session`)**：每张便签自动记录创建或施工时的会话文件路径（`sessionFile`）。在 `/anchor` 面板中点击 `↪ Jump to session`，直接切回当时那场对话。
40
+ **Anchor 与单次对话内的 `todo` 形成了天然互补：它是贴在输入框下沿的「跨会话自动存档点 + 随手便签」**：
41
+ - **自动接管未完 `todo`（Auto-Todo Bridge）**：现有的 `todo` 工具（如 `@juicesharp/rpiv-todo` 与内置 `todo`）只存在于单次对话分支中、不写磁盘，一旦关掉终端或敲 `/new` 开启新会话，没跑完的 `todo` 清单就会全部清空。Anchor 会自动监听 `todo` 进度，把未走完的步骤（如 `[■■□□ 2/5]`）与当前修改的文件自动存为跨会话断点；当同一会话内 `todo` 全部完成（`5/5`）时又会自动清理，全程零手动操作。
42
+ - **输入框正下方常驻 1 行 (`belowEditor`)**：便签条固定在输入框下沿，写代码时抬眼可见；输入框上方空间完全留给 `pi-lingual` 与 `rpiv-todo`；没有便签时自动收起为 0 行。
43
+ - **自己随手敲，0ms 瞬贴 (`便签: ...`)**：直接在输入框敲 `便签: 检查网关超时重试`（或 `pin: ...`、`/pin ...`），输入钩子在 `0.00ms` 内直接拦截上屏，不调用大模型、不耗费 1 个 Token。
44
+ - **原对话一键穿越 (`/back` & `↪ Jump to session`)**：每张便签与自动断点都会记录当时的会话文件路径（`sessionFile`）。敲一句 `/back`（或在 `/anchor` 面板中点击 `↪ Jump to session`），直接切回当时那场对话。
45
45
 
46
46
  ---
47
47
 
@@ -49,9 +49,10 @@ pi install npm:pi-anchor
49
49
 
50
50
  | 操作场景 | 你的输入 | 后台执行逻辑 | 界面即时反馈 | 适用时刻 |
51
51
  | :--- | :--- | :--- | :--- | :--- |
52
+ | **未完 `todo` 自动存档** | AI 调用 `todo` 做到 `2/5` 时你关掉终端或敲 `/new` | 自动同步未完 `todo` 步骤、已改文件与 `sessionFile`；若做到 `5/5` 则自动销毁 | 下次打开终端直接显示：`⌖ #1 [■■□□ 2/5] 替换Cookie ▸ 补单测 (↪)` | 弥补单会话 `todo` 关窗即失忆的短板，实现零操作跨会话续传 |
52
53
  | **0ms 随手贴便签** | 输入框敲 `便签: 把 src/auth.ts 改用 Cookie` | `input` 钩子 0ms 拦截，提取文件路径并记录当前 `sessionFile` | 输入框下方立即浮现：`⌖ #1 把 src/auth.ts 改用 Cookie (app · auth.ts ↪)` | 改代码中途冒出支线念头，不想打断当前对话 |
53
54
  | **分步推进长任务** | 敲 `/pin 重构: 1. 接口 2. Cookie 3. 单测` 后敲 `/step 1` | 解析分步列表并在 `~/.anchor/state.json` 推进完成步数 | 下方便签条实时变为：`⌖ #1 [■■□□ 2/3] 重构 ▸ 单测` | 跨天重构、分步排障或刷课程章节 |
54
- | **切回原对话 (`↪`)** | 敲 `/anchor` 选中便签点 `↪ Jump to session`（或 `/anchor jump 1`） | 调用 Pi 原生 `ctx.switchSession(note.sessionFile)` | 终端直接切回贴这张便签时的完整历史对话上下文 | 隔了几天回来继续施工，需要找回当时的讨论细节 |
55
+ | **切回原对话 (`/back`)** | 敲 `/back`（或 `/anchor` 选中便签点 `↪ Jump to session`） | 调用 Pi 原生 `ctx.switchSession(note.sessionFile)` | 终端直接切回贴这张便签时的完整历史对话上下文 | 隔了几天回来继续施工，需要找回当时的讨论细节 |
55
56
  | **提交代码自动撕** | 执行 `git commit -m "feat: 登录改用 Cookie"` 或敲 `/done 1` | 过滤通用停用词后比对提交信息与便签关键词 | 便签自动归档至 `archive.jsonl`，下方便签条同步消失 | 写完代码顺手提交，免去手动打勾销账 |
56
57
 
57
58
  ---
@@ -90,7 +91,7 @@ Anchor 显式指定 `{ placement: "belowEditor" }` 挂载在输入框下方，
90
91
  | **Pi 斜杠命令** | `/pin <内容>` | 贴一张新便签（支持写 `[1/4]` 或 `1. A 2. B 3. C` 自动生成进度条） |
91
92
  | **Pi 斜杠命令** | `/anchor` | 打开交互面板（回车可撕便签、推进度 `+1`、`↪` 切回原对话 Session、看详情） |
92
93
  | **Pi 斜杠命令** | `/step 1` | 将 `#1` 便签的进度条往前推进 `+1` 步 |
93
- | **Pi 斜杠命令** | `/anchor jump 1` | 直接切换回 `#1` 便签绑定的那场历史对话 (`switchSession`) |
94
+ | **Pi 斜杠命令** | `/back`（或 `/anchor jump 1`） | 一键切换回最近一条未完成便签/`todo` 断点对应的历史对话 (`switchSession`) |
94
95
  | **Pi 斜杠命令** | `/done 1` / `/anchor 1` | 按编号 `#1` 直接撕下便签并归档 |
95
96
  | **Pi 斜杠命令** | `/anchor undo` | 把刚刚撕下的便签重新贴回原位 |
96
97
  | **系统命令行** | `anchor` / `anchor "<内容>"` | 不进 Pi 也能在外部终端查看或贴便签 |
@@ -111,7 +112,7 @@ Anchor 显式指定 `{ placement: "belowEditor" }` 挂载在输入框下方，
111
112
 
112
113
  ```bash
113
114
  npm run typecheck # TypeScript 严格类型检查 (0 错误)
114
- npm test # 原生 Node 测试运行器 (10/10 全绿通过)
115
+ npm test # 原生 Node 测试运行器 (11/11 全绿通过)
115
116
  npm run build # tsup 双格式打包与类型声明生成
116
117
  ```
117
118
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-anchor",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "Cross-session sticky note & auto-todo checkpoint for Pi — automatically saves unfinished todos across terminal restarts, docks a 1-line progress bar [■■□□] below your editor, jumps back to the original session (/back), and auto-clears on git commit.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
package/README_ja.md DELETED
@@ -1,90 +0,0 @@
1
- # ⌖ Anchor
2
-
3
- > **Pi エディタ直下に常駐するデジタル付箋（Sticky Note）拡張機能。**
4
- > `pin: ...` で **0ms 即時貼り付け**、エディタ直下（`belowEditor`）に 1 行で常駐表示（`aboveEditor` 拡張と干渉ゼロ）、長期タスク用の**ミニ進捗バー `[■■□□ 2/4]`**、**元の会話セッションへのワンタッチ復帰（`↪`）**、および **`git commit` 時の自動剥がし**に対応。
5
-
6
- [![npm version](https://img.shields.io/npm/v/pi-anchor?color=blue)](https://www.npmjs.com/package/pi-anchor)
7
- [![npm downloads](https://img.shields.io/npm/dm/pi-anchor?color=22c55e&label=downloads)](https://www.npmjs.com/package/pi-anchor)
8
- [![GitHub stars](https://img.shields.io/github/stars/3ZEROS12/anchor?style=flat&color=f59e0b)](https://github.com/3ZEROS12/anchor/stargazers)
9
- [![CI Status](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml/badge.svg)](https://github.com/3ZEROS12/anchor/actions/workflows/ci.yml)
10
- [![Tests](https://img.shields.io/badge/Tests-10%2F10%20Pass%20(100%25)-brightgreen)](tests/store.test.ts)
11
- [![License: MIT](https://img.shields.io/badge/License-MIT-f97316.svg)](LICENSE)
12
-
13
- [English](./README.md) | **日本語** | [简体中文](./README_zh.md)
14
-
15
- ```bash
16
- pi install npm:pi-anchor
17
- ```
18
-
19
- <p align="center">
20
- <img src="assets/hero-en.svg" alt="Anchor Sticky Notes" width="820">
21
- </p>
22
-
23
- ```text
24
- ╭─ Pi Editor ──────────────────────────────────────────────────────────────────────╮
25
- │ ❯ pin: Refactor auth flow: 1. Extract interface 2. HttpOnly cookie 3. Unit tests │
26
- ╰──────────────────────────────────────────────────────────────────────────────────╯
27
- ⌖ #1 [■■□□ 2/4] Refactor auth flow ▸ Unit tests (app · auth.ts ↪)
28
- ```
29
-
30
- ---
31
-
32
- ## なぜ Anchor なのか？
33
-
34
- コーディング中にふと *「この後 `src/gateway.ts` のレート制限フォールバックも確認しないと」* と思いついたときや、数日かかるタスクを夜に中断するとき：
35
- - リポジトリ内に `TODO.md` を作ると `git status` が汚れ、毎ターンのプロンプトで無駄なトークンを消費します。
36
- - 起動時だけのバナー表示は、最初のメッセージを送信した瞬間に消えてしまい、書いた内容を忘れてしまいます。
37
-
38
- **Anchor は Pi の入力欄のすぐ下（`belowEditor`）に貼る本物のデジタル付箋です。** リポジトリ外の `~/.anchor/state.json` に保存され（全 4 ソースファイル・外部依存ゼロ）、人間の手になじむ 4 つの工夫を備えています：
39
-
40
- ### 1. エディタ直下に 1 行常駐（`belowEditor`）＆ 0ms 即時貼り付け（`pin: ...`）
41
- - **ウィジェット干渉ゼロ**：付箋バーはエディタ**直下（`placement: "belowEditor"`）**に 1 行で配置されるため、エディタ上部（`aboveEditor`）を `pi-lingual` などのツールに 100% 空けておけます。
42
- - **0ms ダイレクト入力**：入力欄で直接 `pin: トークン有効期限を確認`（または `note: ...`、`/pin ...`）と打つだけ。LLM 呼び出しやトークン消費なしで **0.00ms** で即座に貼り付けられ、直前に編集していたファイルが自動リンクされます。
43
-
44
- ### 2. 長期タスク用のミニ進捗バー（`[■■□□ 2/4]`）
45
- - メモの中に比率（`[2/4]` や `5/30`）または番号付きステップ（`1. Extract interface 2. HttpOnly cookie 3. Unit tests`）を書くだけ：
46
- ```text
47
- /pin Refactor auth flow: 1. Extract interface 2. HttpOnly cookie 3. Unit tests
48
- ```
49
- - 付箋バーにミニ進捗バーと次のステップ（`[■■□□ 2/3] ▸ Unit tests`）が表示されます。`/step 1`（または `/anchor` メニューの `▶ Advance step`）で 1 ステップ進みます。単発のメモには進捗バーは表示されません。
50
-
51
- ### 3. 会話セッションのブックマーク（`↪ Jump to session`）
52
- - 各付箋は、作成時や関連ファイル編集時の Pi 会話セッション（`sessionFile`）を自動的にブックマークします。
53
- - 数日後に別ウィンドウから作業を再開したいときも、`/anchor` を開いて **`↪ Jump to session`** を選ぶ（または `/anchor jump 1` を実行する）だけで、当時の会話履歴そのものに直接復帰できます。
54
-
55
- ### 4. ファイル接触時の 1 行メモ注入 ＆ `git commit` 自動剥がし
56
- - **ファイル接触時の 1 行メモ（待機時 0 トークン）**：Turn 1 で一度だけ AI に概要を伝え、Turn 2 以降は **0 トークン**。AI が関連ファイルを読み書きした際、結果の末尾に構文安全な 1 行コメント（`// ⌖ Note #1: ...`）を添えます（`.json` や `.env` は厳格にスキップ）。
57
- - **コミットで自動剥がし**：`git commit -m "..."` のメッセージが付箋内容と一致すると、自動的に付箋を剥がしてアーカイブします（`⌖ Auto-torn off #1`）。誤って剥がした場合は `/anchor undo` でいつでも戻せます。
58
-
59
- ---
60
-
61
- ## コマンド一覧
62
-
63
- | 場所 | 入力 / コマンド | 動作 |
64
- | :--- | :--- | :--- |
65
- | **Pi エディタ** | `pin: <メモ>` または `note: <メモ>` | LLM を呼ばずに **0ms** で付箋を貼り付け |
66
- | **スラッシュコマンド** | `/pin <メモ>` | 新しい付箋を貼る（`[1/4]` や `1. A 2. B` で進捗バー自動生成） |
67
- | **スラッシュコマンド** | `/anchor` | 対話ボードを開く（剥がす、進捗 `+1`、`↪` セッション復帰） |
68
- | **スラッシュコマンド** | `/step 1` | 付箋 `#1` の進捗バーを `+1` 進める |
69
- | **スラッシュコマンド** | `/anchor jump 1` | 付箋 `#1` に紐づく元の会話セッションへ切り替え |
70
- | **スラッシュコマンド** | `/done 1` / `/anchor undo` | 付箋 `#1` を剥がす / 直前に剥がした付箋を貼り直す |
71
- | **ターミナル CLI** | `anchor` / `anchor step 1` / `anchor done 1` | Pi の外から付箋の一覧確認・進捗更新・完了を実行 |
72
-
73
- ---
74
-
75
- ## Ecosystem: Pi Terminal Suite
76
-
77
- 4 つの拡張機能はそれぞれ異なるターミナルスロット（`aboveEditor`、`belowEditor`、`status-only` フッター、実行時ツールフック）にマウントされるため、単体でも全種併用でも UI が干渉しません：
78
-
79
- | パッケージ | ターミナル配置スロットと機構 | インストール |
80
- | :--- | :--- | :--- |
81
- | **[`pi-lingual`](https://github.com/3ZEROS12/pi-lingual)** | `二 ⇄ two` `aboveEditor` 二言語 HUD（最大 9 行・UAX #11 ツリーレイアウト）＆英語プロンプト変換（履歴トークン消費 0） | `pi install npm:pi-lingual` |
82
- | **[`toolflow`](https://github.com/3ZEROS12/toolflow)** | `⌬` 実行時ツールフック —— フェーズ別 MCP マウント＆40 行超のログ自動ディスク退避（ログトークン 95% 削減） | `pi install npm:toolflow` |
83
- | **[`pi-tui-status-beautifier`](https://github.com/3ZEROS12/pi-tui-status-beautifier)** | `status-only` フッターフック —— 6 種のバッジプリセット、`<80` 列での待機バッジ折りたたみ `(+N idle)`、描画ループ内ディスク I/O ゼロ | `pi install npm:pi-tui-status-beautifier` |
84
- | **[`pi-anchor`](https://github.com/3ZEROS12/anchor)** *(現在)* | `⌖` `belowEditor` 1 行常駐付箋バー、0ms `pin:` インターセプト、ミニ進捗バー `[■■□□]` ＆ `↪` セッション復帰 | `pi install npm:pi-anchor` |
85
-
86
- ---
87
-
88
- ## ライセンス
89
-
90
- MIT © [Jason Song](https://github.com/3ZEROS12)