@yukino.js/yukino 0.0.16 → 0.0.18
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 +319 -106
- package/dist/anthropic-SNLPAGHS.js +4 -0
- package/dist/browser/dist/static/{highlight-AZCRQTGM.js → highlight-3YCG6EL4.js} +15 -15
- package/dist/browser/dist/static/index.css +1 -1
- package/dist/browser/dist/static/index.js +133 -88
- package/dist/browser/dist/static/webapi-2B2CRWRA.js +4 -0
- package/dist/{bwrap-LVIPV72Q.js → bwrap-7KSHJ46M.js} +1 -1
- package/dist/{seatbelt-UO7HGD4Z.js → chunk-27PD4NBA.js} +1 -1
- package/dist/chunk-5ZELCP2G.js +4 -0
- package/dist/{chunk-4JHZPFU6.js → chunk-7S5SR6KL.js} +11 -11
- package/dist/chunk-BPGCPI76.js +18 -0
- package/dist/chunk-CTYNHZ3Y.js +38 -0
- package/dist/chunk-CYKTCSRI.js +866 -0
- package/dist/chunk-CZGLX3AK.js +4 -0
- package/dist/chunk-F7FUNBYM.js +8 -0
- package/dist/{chunk-ETZPOVUC.js → chunk-HRAX6543.js} +1 -1
- package/dist/{chunk-SA7KQIVH.js → chunk-ILSOSAOB.js} +30 -36
- package/dist/{chunk-SX477ANO.js → chunk-IO3PJG3N.js} +1 -1
- package/dist/{chunk-K45OXLJJ.js → chunk-K6F424MN.js} +1 -1
- package/dist/chunk-KEPFYD6K.js +4 -0
- package/dist/chunk-N7ARR77W.js +5 -0
- package/dist/{chunk-FC2LG24U.js → chunk-QZ5RINXE.js} +1 -1
- package/dist/chunk-UQM7BD5K.js +35 -0
- package/dist/{chunk-LR4ZNAAM.js → chunk-W2VWX7HR.js} +1 -1
- package/dist/chunk-WLJL66O5.js +4 -0
- package/dist/chunk-XN7SUAOW.js +4 -0
- package/dist/{chunk-XY7ZFVZL.js → chunk-XQCCZYMT.js} +1 -1
- package/dist/chunk-ZESFB5XU.js +30 -0
- package/dist/{esm-2JJG3HR7.js → esm-6WYDAALC.js} +1 -1
- package/dist/{esm-IBZKE3IU.js → esm-7VCKZ3CE.js} +1 -1
- package/dist/{esm-Y237QNPJ.js → esm-AFNMXGOY.js} +1 -1
- package/dist/{esm-W4NAAZTQ.js → esm-BOD3YQPE.js} +1 -1
- package/dist/{esm-EOOB75BT.js → esm-MYMSBMIY.js} +1 -1
- package/dist/{esm-7DWXO52B.js → esm-RASD3BGK.js} +1 -1
- package/dist/esm-UKQMXG2A.js +4 -0
- package/dist/file-type-P5MHDLHF.js +12 -0
- package/dist/{getMachineId-bsd-E27XJQLX.js → getMachineId-bsd-MTZJBHHS.js} +1 -1
- package/dist/{getMachineId-bsd-A3UCSHLE.js → getMachineId-bsd-SR65JA23.js} +1 -1
- package/dist/{getMachineId-darwin-35UPAIXP.js → getMachineId-darwin-J7BNWNFS.js} +1 -1
- package/dist/{getMachineId-darwin-MWJEU7OI.js → getMachineId-darwin-UX2LWEFP.js} +1 -1
- package/dist/{getMachineId-linux-MKXIYT6A.js → getMachineId-linux-RNGA35ZF.js} +1 -1
- package/dist/{getMachineId-linux-FNSLKUDN.js → getMachineId-linux-XGLIABQN.js} +1 -1
- package/dist/{getMachineId-unsupported-ZXVGGFX2.js → getMachineId-unsupported-4ACRY4OO.js} +1 -1
- package/dist/{getMachineId-unsupported-PKQWB2OJ.js → getMachineId-unsupported-JDNTBZDQ.js} +1 -1
- package/dist/{getMachineId-win-RNVIYJG5.js → getMachineId-win-BLVGSBMB.js} +1 -1
- package/dist/{getMachineId-win-3A667JT3.js → getMachineId-win-PANZD46Y.js} +1 -1
- package/dist/image-worker.js +249 -0
- package/dist/lib/{anthropic-2P54PIDT.js → anthropic-UZWRSZSZ.js} +4 -5
- package/dist/lib/bwrap-QS7XL6I5.js +8 -0
- package/dist/lib/chunk-7YTS74LF.js +21 -0
- package/dist/lib/{chunk-7JP46P5T.js → chunk-EYSD63EM.js} +365 -64
- package/dist/lib/chunk-F66UUNE7.js +1307 -0
- package/dist/lib/{chunk-PCZ63WQL.js → chunk-GAEGBBZQ.js} +7 -3
- package/dist/lib/{chunk-OEX5PMME.js → chunk-I7AT5Q45.js} +164 -61
- package/dist/lib/{chunk-XLRV26YW.js → chunk-IUZTNHDX.js} +6 -3
- package/dist/lib/{chunk-NYPUPN23.js → chunk-KKAVW72Q.js} +84 -35
- package/dist/lib/chunk-T33QIWPB.js +1768 -0
- package/dist/lib/chunk-TRGKUGHQ.js +176 -0
- package/dist/lib/image-worker.d.ts +2 -0
- package/dist/lib/image-worker.js +158 -0
- package/dist/lib/index.d.ts +4962 -1674
- package/dist/lib/index.js +27337 -17789
- package/dist/lib/{openai-7NAYCBDV.js → openai-UB67SMOX.js} +4 -4
- package/dist/lib/{providers-YRINFWH2.js → providers-YZB3ZC4N.js} +3 -3
- package/dist/lib/seatbelt-HINSTYTF.js +8 -0
- package/dist/{main-J7UMFVZ5.js → main-XRZCWPXW.js} +282 -221
- package/dist/main.js +5 -5
- package/dist/{openai-HCAV4QMK.js → openai-SVRRJUPW.js} +17 -17
- package/dist/providers-KK4H4FPS.js +4 -0
- package/dist/seatbelt-O343XIHU.js +4 -0
- package/dist/server-SHFUKQA4.js +15 -0
- package/dist/server-ZYMTEUKF.js +4 -0
- package/dist/src-32KR7AJY.js +4 -0
- package/dist/src-7S4T5QVZ.js +4 -0
- package/dist/src-EZJEUBJC.js +4 -0
- package/dist/src-VLEWSGZD.js +12 -0
- package/dist/stdio-DWJD5XUT.js +5 -0
- package/dist/websocket-5P5FBVU6.js +9 -0
- package/package.json +21 -17
- package/dist/anthropic-M6YBGTW2.js +0 -4
- package/dist/chunk-3O2CPTOD.js +0 -5
- package/dist/chunk-5DGLAJ3U.js +0 -8
- package/dist/chunk-BOZOXLKL.js +0 -4
- package/dist/chunk-CUCQV3CL.js +0 -4
- package/dist/chunk-H7DHVEP7.js +0 -30
- package/dist/chunk-I74AL3PF.js +0 -5
- package/dist/chunk-JL3K6GYG.js +0 -114
- package/dist/chunk-KJJYW5IY.js +0 -4
- package/dist/chunk-LCWNSYZU.js +0 -4
- package/dist/chunk-MHRZYJJO.js +0 -4
- package/dist/chunk-MQAQBW7F.js +0 -35
- package/dist/chunk-Q6PJ2RD6.js +0 -988
- package/dist/chunk-VCIRD267.js +0 -4
- package/dist/chunk-XKLTUIST.js +0 -18
- package/dist/esm-H73EL6IR.js +0 -4
- package/dist/lib/bwrap-JS5GRKWY.js +0 -7
- package/dist/lib/chunk-3HK5RKES.js +0 -266
- package/dist/lib/chunk-3QG36U3U.js +0 -853
- package/dist/lib/chunk-LU6NOWNY.js +0 -592
- package/dist/lib/chunk-NCMYMV2M.js +0 -5464
- package/dist/lib/chunk-OFDOP6I2.js +0 -68
- package/dist/lib/seatbelt-LDM6UB6N.js +0 -7
- package/dist/lib/tool-filter-LYVHXM4N.js +0 -21
- package/dist/providers-SPLB2SQZ.js +0 -4
- package/dist/server-HBQZYHGG.js +0 -4
- package/dist/server-R4SJR6ZG.js +0 -15
- package/dist/src-DEVJGNXS.js +0 -4
- package/dist/src-EMFESWQS.js +0 -4
- package/dist/src-GG4YROJH.js +0 -4
- package/dist/src-JFAO2DGP.js +0 -12
- package/dist/stdio-INHOYWG6.js +0 -5
- package/dist/tool-filter-GPC6HF2N.js +0 -4
- package/dist/websocket-KLVXQWQZ.js +0 -9
- /package/dist/{chunk-FNQMXCCE.js → chunk-D6YQITPD.js} +0 -0
- /package/dist/{chunk-3KKA6537.js → chunk-GJASU6E3.js} +0 -0
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@ Beyond interactive use, Yukino supports a non-interactive print mode for scripti
|
|
|
14
14
|
|
|
15
15
|
- Multi-provider LLM support with Anthropic (Anthropic Messages), OpenAI (OpenAI Responses), and OpenAI-compatible (OpenAI Chat Completions) protocols
|
|
16
16
|
- Interactive terminal UI with streaming text, thinking indicators, and tool execution display
|
|
17
|
-
- Built-in tool set: ReadFile, WriteFile, EditFile, Bash, PowerShell, Glob, Grep, WebFetch, LSP, ComputerUse, ToolSearch, McpCall, EnterWorktree, ExitWorktree, ExitPlanMode, Goal, the
|
|
17
|
+
- Built-in tool set: ReadFile, WriteFile, EditFile, Bash, PowerShell, Glob, Grep, WebFetch, LSP, ComputerUse, ToolSearch, McpCall, EnterWorktree, ExitWorktree, ExitPlanMode, Goal, the TodoWrite tracking tool, plus Workflow, Agent, LoadSkill, InstallSkill, AskUserQuestion, SyntheticOutput, TeamCreate, SendMessage, TeamDelete, TaskOutput, and TaskStop
|
|
18
18
|
- MCP (Model Context Protocol) server integration for extending the tool set with external services
|
|
19
19
|
- Permission system with four modes: default, acceptEdits, plan (read-only), and bypassPermissions
|
|
20
20
|
- Sandbox support for isolated command execution (bwrap on Linux, seatbelt on macOS)
|
|
@@ -44,7 +44,7 @@ Beyond interactive use, Yukino supports a non-interactive print mode for scripti
|
|
|
44
44
|
- Session-local persistent goals with automatic continuation, explicit pause/resume, token budgets, and completion/blocker audits
|
|
45
45
|
- Automatic context compaction when conversations approach the model's context window
|
|
46
46
|
- Long-term memory extraction and recall across sessions (disable with `enable_memory: false` in `~/.yukino/config.yaml`)
|
|
47
|
-
- Instructions files for persistent guidance: user-global `~/.yukino/AGENTS.md`, plus `AGENTS.md` in every directory from the git root down to the working directory
|
|
47
|
+
- Instructions files for persistent guidance: user-global `~/.yukino/AGENTS.md`, plus `AGENTS.md` in every directory from the git root down to the working directory; instruction files are read literally
|
|
48
48
|
|
|
49
49
|
### Skills and Commands
|
|
50
50
|
|
|
@@ -94,7 +94,7 @@ curl -fsSL https://raw.githubusercontent.com/hangtiancheng/yukino-code/main/inst
|
|
|
94
94
|
irm https://raw.githubusercontent.com/hangtiancheng/yukino-code/main/install.ps1 | iex
|
|
95
95
|
```
|
|
96
96
|
|
|
97
|
-
Both installers write a default `~/.yukino/config.yaml` if none exists, verify Node.js >= 20, and support uninstall / pinned-version / dist-tag options (see their `--help` / `-
|
|
97
|
+
Both installers write a default `~/.yukino/config.yaml` if none exists, verify Node.js >= 20, and support uninstall / pinned-version / dist-tag options (see their `--help` / `-h` output).
|
|
98
98
|
|
|
99
99
|
Update a global npm, yarn, or pnpm installation with:
|
|
100
100
|
|
|
@@ -104,9 +104,9 @@ yukino update --tag=canary
|
|
|
104
104
|
yukino --version
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
The command checks npm's `latest` dist-tag by default. Use `--tag=canary` (or `--tag canary`) to check another dist-tag. If its version is newer according to SemVer, the command installs that exact version using the package manager that provides the current installation. For example, `0.0.
|
|
107
|
+
The command checks npm's `latest` dist-tag by default. Use `--tag=canary` (or `--tag canary`) to check another dist-tag. If its version is newer according to SemVer, the command installs that exact version using the package manager that provides the current installation. For example, `0.0.10-canary` is newer than `0.0.8-dev`. Equal or older versions are not installed. Both one-line installers use npm, so their installations support `yukino update` too. Source checkouts must be updated from the repository.
|
|
108
108
|
|
|
109
|
-
The TUI checks npm's `latest` dist-tag for a newer release asynchronously and shows a `yukino update` hint on entry when one is available. The hint disappears after the first input submission or when a session is resumed; late check results stay hidden during the conversation. Available updates are shown again on the last line of the exit summary. Network errors do not interrupt the UI.
|
|
109
|
+
The TUI always checks npm's `latest` dist-tag for a newer release asynchronously and shows a `yukino update` hint on entry when one is available. The hint disappears after the first input submission or when a session is resumed; late check results stay hidden during the conversation. Available updates are shown again on the last line of the exit summary. Network errors do not interrupt the UI. Explicit `yukino update` also checks for updates.
|
|
110
110
|
|
|
111
111
|
Or run directly from the monorepo:
|
|
112
112
|
|
|
@@ -116,57 +116,61 @@ pnpm dev
|
|
|
116
116
|
|
|
117
117
|
## Storage
|
|
118
118
|
|
|
119
|
-
Yukino stores its configuration and runtime state under `~/.yukino`. The current directory (`cwd`) determines where tools execute and which project `/resume` opens. It does not determine the storage root. Directories are created when their features are used.
|
|
119
|
+
Yukino stores its configuration and runtime state under `~/.yukino`. The current directory (`cwd`) determines where tools execute and which project `/resume` opens. It does not determine the storage root. Directories are created when their features are used. On POSIX, Yukino state directories use `0700` and state files use `0600`, including existing files reopened for reading or appending and temporary files used for atomic replacement. This policy covers runtime state, configuration and memory; it does not chmod working-tree source files. State writes reject symbolic links. These mode bits do not establish a Windows ACL policy.
|
|
120
120
|
|
|
121
|
-
```
|
|
122
|
-
~/.yukino/
|
|
123
|
-
├── config.yaml
|
|
124
|
-
├── AGENTS.md
|
|
125
|
-
├── permissions.yaml
|
|
126
|
-
├──
|
|
127
|
-
├──
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
│
|
|
134
|
-
├── memory/
|
|
135
|
-
│ ├── MEMORY.md
|
|
136
|
-
│ └── <memory>.md
|
|
137
|
-
├── projects/
|
|
138
|
-
│ └── <project-key>/
|
|
139
|
-
│ ├── permissions.yaml
|
|
140
|
-
│ └── memory/
|
|
141
|
-
│ ├── MEMORY.md
|
|
142
|
-
│ └── <memory>.md
|
|
143
|
-
├── sessions/
|
|
144
|
-
│ ├── <project-key>/
|
|
145
|
-
│ │ └── <session-id>.jsonl
|
|
146
|
-
│ └── artifacts/
|
|
147
|
-
│ └── <session-id>/
|
|
148
|
-
│ ├── tasks.json
|
|
149
|
-
│ ├── file-history/
|
|
150
|
-
│ │ ├── snapshots.json
|
|
151
|
-
│ │ ├── <file-backup>
|
|
152
|
-
│ │ └── <clipboard-image>.png
|
|
153
|
-
│ └── tool-results/
|
|
154
|
-
│ ├── <tool-call-id>.txt
|
|
155
|
-
│ └── shell-<random>.output
|
|
156
|
-
├── plans/
|
|
157
|
-
│ └── <slug>.md
|
|
158
|
-
├── logs/
|
|
159
|
-
│ └── <session-id>.jsonl
|
|
160
|
-
├── crash.log
|
|
161
|
-
├── teams/
|
|
162
|
-
│ └── <project-key
|
|
163
|
-
│
|
|
164
|
-
│
|
|
165
|
-
│
|
|
166
|
-
│
|
|
167
|
-
└──
|
|
168
|
-
|
|
169
|
-
|
|
121
|
+
```yaml
|
|
122
|
+
~/.yukino/ # Per-user storage root for global configuration, reusable definitions, project/session state and diagnostics.
|
|
123
|
+
├── config.yaml # Provider endpoints, credentials and models; default provider, permission mode, hooks, MCP/LSP and runtime settings.
|
|
124
|
+
├── AGENTS.md # Global Markdown instructions and coding/workflow rules supplied to sessions in every project.
|
|
125
|
+
├── permissions.yaml # User-wide Tool(pattern) permission rules and their effects, evaluated alongside project-specific rules.
|
|
126
|
+
├── activity.jsonl # Input events with IDs, timestamps, cwd, session, source, text and command names; project registry and usage checkpoints.
|
|
127
|
+
├── prompts/ # Global reusable slash-command templates; nested directories provide command namespaces.
|
|
128
|
+
│ └── <command>.md # Markdown prompt body and optional YAML metadata; its relative path determines the slash-command name.
|
|
129
|
+
├── agents/ # User-defined agent profiles that add agents or override built-in agent definitions by name.
|
|
130
|
+
│ └── <agent>.md # YAML model/tool/permission/turn-limit settings plus Markdown task instructions and optional system-prompt override.
|
|
131
|
+
├── skills/ # Yukino-specific global skill catalog, including skills installed through InstallSkill.
|
|
132
|
+
│ └── <skill>/ # One reusable skill package, with its entrypoint and any accompanying scripts, references or assets.
|
|
133
|
+
│ └── SKILL.md # Skill name, description and execution metadata in YAML frontmatter, followed by Markdown workflow instructions.
|
|
134
|
+
├── memory/ # User-scoped long-term memory shared across projects, including preferences and feedback about assistant behavior.
|
|
135
|
+
│ ├── MEMORY.md # Global memory entrypoint containing concise topic links and summaries for inclusion in model context.
|
|
136
|
+
│ └── <memory>.md # Individual user/feedback memory: YAML name, description and type, followed by detailed Markdown content.
|
|
137
|
+
├── projects/ # Project-scoped permission and memory state, isolated by canonical working-directory identity.
|
|
138
|
+
│ └── <project-key>/ # One project namespace; the key is the SHA-256 hash of its canonical absolute cwd.
|
|
139
|
+
│ ├── permissions.yaml # Project Tool(pattern) rules, including persisted allow-always approvals for tool operations.
|
|
140
|
+
│ └── memory/ # Long-term knowledge about this project, such as architecture, conventions, decisions and reference material.
|
|
141
|
+
│ ├── MEMORY.md # Project memory entrypoint with concise links to project topics and shared global memories.
|
|
142
|
+
│ └── <memory>.md # Project/reference memory with YAML name, description and type plus detailed Markdown facts or guidance.
|
|
143
|
+
├── sessions/ # Conversation transcripts grouped by project, plus a separate namespace for session-owned artifacts.
|
|
144
|
+
│ ├── <project-key>/ # Transcript namespace for one canonical cwd, used by project-local resume and global session enumeration.
|
|
145
|
+
│ │ └── <session-id>.jsonl # Messages, user-input provenance, tool calls/results, thinking blocks, user Bash records, compaction boundaries and goal state.
|
|
146
|
+
│ └── artifacts/ # Session-owned supporting data, keyed by session ID independently of the executing agent's current directory.
|
|
147
|
+
│ └── <session-id>/ # One session's private task list, file-rewind data, clipboard images and persisted tool/shell output.
|
|
148
|
+
│ ├── tasks.json # Private task list with subjects, descriptions, status, owners, dependencies, metadata, priorities and nextId counter.
|
|
149
|
+
│ ├── file-history/ # File-rewind checkpoints and original file bytes, together with clipboard image attachments for this session.
|
|
150
|
+
│ │ ├── snapshots.json # Tracked paths, checkpoint metadata, transcript line positions, baseline states, backup paths and backup sequence counter.
|
|
151
|
+
│ │ ├── <file-backup> # Original file bytes for first-tracked baselines and per-checkpoint versions used to restore workspace files.
|
|
152
|
+
│ │ └── <clipboard-image>.png # Clipboard image bytes; prompt @ references load these PNGs as image attachments in user messages.
|
|
153
|
+
│ └── tool-results/ # Full tool responses and shell capture files that remain accessible beyond shortened context/UI previews.
|
|
154
|
+
│ ├── <tool-call-id>.txt # Full text of a spilled tool result, addressed by the encoded tool-call ID and referenced from shortened results.
|
|
155
|
+
│ └── shell-<random>.output # Captured shell stdout/stderr, including complete command output beyond the in-memory preview.
|
|
156
|
+
├── plans/ # Markdown plan documents shared through explicit per-session plan-file references.
|
|
157
|
+
│ └── <slug>.md # One plan's Markdown content, used by plan-mode editing, user approval and subsequent plan execution.
|
|
158
|
+
├── logs/ # Main-process structured diagnostics, grouped by the logging runtime's session ID.
|
|
159
|
+
│ └── <session-id>.jsonl # Pino warn/error/fatal events with timestamps, session/mode/module context and structured error details.
|
|
160
|
+
├── crash.log # Timestamped process starts/exits, terminal disconnections and crash stack traces for post-mortem diagnosis.
|
|
161
|
+
├── teams/ # Persistent team coordination state, isolated by project and team identity.
|
|
162
|
+
│ └── <project-key>/ # Teams belonging to one canonical cwd; prevents unrelated projects from sharing rosters, tasks or mailboxes.
|
|
163
|
+
│ └── <team>/ # One sanitized team-name namespace containing its roster, shared task board, mailboxes and teammate diagnostics.
|
|
164
|
+
│ ├── config.json # Team metadata, leader ID, permission mode and member IDs/types/models/activity flags/worktree paths.
|
|
165
|
+
│ ├── tasks.json # Team-wide task board with creators, owners, statuses, dependencies, task metadata and nextId counter.
|
|
166
|
+
│ ├── inboxes/ # Recipient-specific persistent mailboxes for communication between the leader and teammates.
|
|
167
|
+
│ │ └── <member>.json # Message array with sender, text, timestamp, read state and optional protocol type/request ID/approval response.
|
|
168
|
+
│ └── logs/ # Structured diagnostics from teammate processes, separated from main-process logs.
|
|
169
|
+
│ └── <session-id>.jsonl # One teammate runtime's warn/error/fatal events, with session/mode/module context and error details.
|
|
170
|
+
└── worktrees/ # Git worktrees used to isolate agent changes from the original checkout.
|
|
171
|
+
└── <repository-key>/ # Repository namespace keyed by the canonical Git repository root; shared across its subdirectories.
|
|
172
|
+
└── <slug>/ # Named worktree location for an EnterWorktree invocation or a worktree-enabled agent.
|
|
173
|
+
└── <Git working tree> # Checked-out source files on the worktree branch, the .git link file and copied project .agents resources.
|
|
170
174
|
```
|
|
171
175
|
|
|
172
176
|
### Global resources
|
|
@@ -175,7 +179,7 @@ Yukino stores its configuration and runtime state under `~/.yukino`. The current
|
|
|
175
179
|
|
|
176
180
|
`prompts/` contains user slash-command templates, `agents/` contains agent definitions that can override built-in definitions, and `skills/` contains skills installed by `InstallSkill`. Skill discovery also reads standard `~/.agents/skills/` and project `.agents/skills/`, in this order: global standard skills, global Yukino skills, then project standard skills. Later entries override earlier names. Project `AGENTS.md` and `.mcp.json` remain ordinary project resources.
|
|
177
181
|
|
|
178
|
-
`
|
|
182
|
+
`activity.jsonl` records user input, canonical project directories, and resolved command names across CLI, WebSocket, ACP and print mode. It preserves separate events for identical submissions; input recall merges consecutive duplicate texts and retains the latest 10,000 events. Periodic atomic checkpoints retain cumulative command usage and all registered projects while bounding input history. Writes and checkpoint replacement share a cross-process lock. The old prompt-history and command-usage files are no longer read or written. `memory/` stores user memories shared across projects, while `plans/` stores plan documents; each live session tracks its active plan path. `logs/` contains main-process logs and `crash.log` records process exits and failures.
|
|
179
183
|
|
|
180
184
|
### Project namespaces and resume
|
|
181
185
|
|
|
@@ -193,16 +197,20 @@ Session cleanup removes conversations inactive for more than 30 days together wi
|
|
|
193
197
|
|
|
194
198
|
Each `teams/<project-key>/<team>/` contains team membership and process metadata in `config.json`, the shared task board in `tasks.json`, one JSON mailbox per member in `inboxes/`, and teammate logs in `logs/`. The private session task list and the team task board use separate files.
|
|
195
199
|
|
|
200
|
+
Both task files use `{ nextId, tasks }`. `nextId` is the positive integer allocated to the next new task; task IDs are positive decimal strings such as `"1"`. Deleting tasks preserves the counter, so later tasks do not reuse deleted IDs. TodoWrite reads and edits the complete task model, including structured `metadata`. Metadata edits merge top-level keys, with `null` deleting a key and nested values replaced as a whole; omitted fields retain their values.
|
|
201
|
+
|
|
196
202
|
### Git worktrees
|
|
197
203
|
|
|
198
204
|
Every Yukino-created worktree is stored at `~/.yukino/worktrees/<repository-key>/<slug>/`. The repository key uses the same SHA-256 algorithm as project keys, applied to the canonical Git repository root rather than the caller's subdirectory. Calls from different subdirectories of the same repository therefore place worktrees together. Different repositories have separate directories even when they use the same slug.
|
|
199
205
|
|
|
200
|
-
For example, a worktree named `fix-login` created from `/workspace/repo/app` is placed in `~/.yukino/worktrees/<SHA-256 of /workspace/repo>/fix-login/`, with branch `worktree
|
|
206
|
+
For example, a worktree named `fix-login` created from `/workspace/repo/app` is placed in `~/.yukino/worktrees/<SHA-256 of /workspace/repo>/fix-login/`, with branch `worktree/fix-login/work`. Yukino returns the absolute worktree path to the caller. Git's own worktree metadata remains in the repository's Git directory; `git worktree list` shows the registered paths.
|
|
201
207
|
|
|
202
|
-
Global configuration, prompts, agent definitions, and installed skills are shared directly with the worktree. Standard project `.agents` resources are copied into it. No project `.yukino` settings are copied.
|
|
208
|
+
Global configuration, prompts, agent definitions, and installed skills are shared directly with the worktree. Standard project `.agents` resources are copied into it. No project `.yukino` settings are copied. `EnterWorktree` accepts an optional `slug` (randomly generated when omitted) and switches the agent's working directory into the worktree. `ExitWorktree` operates on that agent's active session with `{ action: "keep" | "remove", discard_changes?: boolean }` and restores the original working directory. `keep` preserves the directory and branch; `remove` deletes both, using the runtime's recorded repository, branch, Git identity and initial HEAD. Removal refuses changed files, new commits, or unverifiable state unless the user confirms discarding work and `discard_changes` is true. With no active session, exit is a no-op. Existing trees from another runtime are never adopted. Project identity for resume, memory, and permissions stays anchored to the original project; starting a separate session directly in a worktree uses that directory's own project namespace.
|
|
203
209
|
|
|
204
210
|
Yukino does not read or create a project `.yukino` directory. Existing project-local state is not automatically migrated; it must be moved to the corresponding global paths before it can be resumed.
|
|
205
211
|
|
|
212
|
+
Session lists order by the last persisted real user input, excluding tool results and internal reminders. Read-only transcript loads do not refresh modification time; explicit resume renews expiry under the transcript lock without changing ordering. Conversation rewind restores the ordering time of the remaining messages. `Session.listAllSessions()` returns globally ordered sessions with their canonical `cwd` and `projectKey`, using the activity log project registry. Projects without recoverable directory metadata are discovered when their known cwd is registered; older messages without user-input provenance have no last-user-message time.
|
|
213
|
+
|
|
206
214
|
## Configuration
|
|
207
215
|
|
|
208
216
|
Yukino reads a single global YAML configuration file:
|
|
@@ -214,7 +222,7 @@ Print, remote, ACP, and A2A modes require at least one configured provider; the
|
|
|
214
222
|
```yaml
|
|
215
223
|
# Initial permission mode. Enum: default (ask per write/command) | acceptEdits (auto-approve
|
|
216
224
|
# file edits) | bypassPermissions (approve everything).
|
|
217
|
-
# Other values fall back to default. Shift+Tab cycles these modes
|
|
225
|
+
# Other values fall back to default. Shift+Tab cycles only these three modes.
|
|
218
226
|
permission_mode: bypassPermissions
|
|
219
227
|
|
|
220
228
|
# Model providers. At least one is required.
|
|
@@ -254,11 +262,65 @@ enable_memory: false
|
|
|
254
262
|
# (team/task management) so all actual work is delegated to teammates.
|
|
255
263
|
enable_coordinator_mode: false
|
|
256
264
|
|
|
257
|
-
#
|
|
258
|
-
#
|
|
259
|
-
# a fresh general-purpose subagent instead.
|
|
265
|
+
# Default value of the Agent tool's fork parameter, independent of subagent_type.
|
|
266
|
+
# Default: true. Each call can explicitly set fork: true or fork: false to override it.
|
|
260
267
|
enable_fork: true
|
|
261
268
|
|
|
269
|
+
# MCP tool loading: auto | eager | native | dispatch. Default: auto, decided per session
|
|
270
|
+
# from the provider protocol, endpoint and schema size. Native loading on a non-Anthropic
|
|
271
|
+
# protocol falls back to dispatch. Applies to TUI, print, remote, ACP and A2A modes.
|
|
272
|
+
mcp_loading: auto
|
|
273
|
+
|
|
274
|
+
# Terminal theme: auto | dark | light. Default: auto, detected from COLORFGBG or terminal
|
|
275
|
+
# color reports; falls back to dark when detection is unavailable.
|
|
276
|
+
theme: auto
|
|
277
|
+
|
|
278
|
+
# Environment variable defaults. Supported configuration is limited to Yukino-specific
|
|
279
|
+
# YUKINO_* test/integration inputs and OTEL_*, LANGFUSE_*, SENTRY_* telemetry settings.
|
|
280
|
+
# Product settings use the typed YAML fields above. Other environment
|
|
281
|
+
# variables are read-only inputs from the host environment; configure them outside this block.
|
|
282
|
+
# Explicit environment always wins, including an explicitly empty string. Scalars are
|
|
283
|
+
# stringified (1 → "1"); an empty value becomes ""; a bare `env:` is a no-op. Unset variables
|
|
284
|
+
# are filled before telemetry starts and on config loads. A list of single-key mappings
|
|
285
|
+
# (`- KEY: value`) is also accepted. See the variable reference below for scope and defaults.
|
|
286
|
+
env:
|
|
287
|
+
# ── E2E test settings ────────────────────────────────────────────────────────────
|
|
288
|
+
# YUKINO_TEST_API_KEY: test-key # Enables the real-provider memory consolidation test
|
|
289
|
+
# YUKINO_TEST_BASE_URL: https://api.deepseek.com # Default test provider endpoint
|
|
290
|
+
# YUKINO_TEST_MODEL: deepseek-flash # Default test model
|
|
291
|
+
# YUKINO_TEST_PROTOCOL: openai-compat # anthropic | openai | openai-compat (default)
|
|
292
|
+
# ── OpenTelemetry — see the Telemetry section; telemetry stays off without exporters ─
|
|
293
|
+
# OTEL_SDK_DISABLED: "true" # true disables OpenTelemetry and Langfuse tracing
|
|
294
|
+
# OTEL_SERVICE_NAME: yukino # Service name; defaults to yukino
|
|
295
|
+
# OTEL_RESOURCE_ATTRIBUTES: deployment.environment.name=production
|
|
296
|
+
# OTEL_TRACES_EXPORTER: otlp # Comma-separated: otlp | console | none
|
|
297
|
+
# OTEL_LOGS_EXPORTER: otlp # Comma-separated: otlp | console | none
|
|
298
|
+
# OTEL_METRICS_EXPORTER: otlp # Comma-separated: otlp | console | prometheus | none
|
|
299
|
+
# OTEL_EXPORTER_OTLP_PROTOCOL: http/protobuf # Shared protocol: grpc | http/json | http/protobuf
|
|
300
|
+
# OTEL_EXPORTER_OTLP_TRACES_PROTOCOL: http/protobuf # Per-signal protocol overrides
|
|
301
|
+
# OTEL_EXPORTER_OTLP_LOGS_PROTOCOL: http/protobuf
|
|
302
|
+
# OTEL_EXPORTER_OTLP_METRICS_PROTOCOL: http/protobuf
|
|
303
|
+
# OTEL_EXPORTER_OTLP_ENDPOINT: https://collector.example.com # Shared collector endpoint
|
|
304
|
+
# OTEL_EXPORTER_OTLP_TRACES_ENDPOINT: https://collector.example.com/v1/traces
|
|
305
|
+
# OTEL_EXPORTER_OTLP_LOGS_ENDPOINT: https://collector.example.com/v1/logs
|
|
306
|
+
# OTEL_EXPORTER_OTLP_METRICS_ENDPOINT: https://collector.example.com/v1/metrics
|
|
307
|
+
# OTEL_EXPORTER_OTLP_HEADERS: authorization=Bearer token
|
|
308
|
+
# OTEL_METRIC_EXPORT_INTERVAL: 60000 # Metric export interval in ms; defaults to 60000
|
|
309
|
+
# ── Langfuse — enabled when both keys are set ──────────────────────────────────────
|
|
310
|
+
# LANGFUSE_PUBLIC_KEY: pk-lf-xxx
|
|
311
|
+
# LANGFUSE_SECRET_KEY: sk-lf-xxx
|
|
312
|
+
# LANGFUSE_BASE_URL: https://cloud.langfuse.com # Cloud or self-hosted endpoint
|
|
313
|
+
# LANGFUSE_TRACING_ENVIRONMENT: production # Environment attached to traces
|
|
314
|
+
# LANGFUSE_RELEASE: 1.0.0 # Defaults to the Yukino version
|
|
315
|
+
# LANGFUSE_FLUSH_AT: 15 # Spans accumulated before export
|
|
316
|
+
# LANGFUSE_FLUSH_INTERVAL: 0.5 # Batch flush interval in seconds
|
|
317
|
+
# LANGFUSE_TIMEOUT: 3 # Export request timeout in seconds
|
|
318
|
+
# ── Sentry — enabled when SENTRY_DSN is set ────────────────────────────────────────
|
|
319
|
+
# SENTRY_DSN: https://xxx@yyy.ingest.sentry.io/1
|
|
320
|
+
# SENTRY_ENVIRONMENT: production
|
|
321
|
+
# SENTRY_RELEASE: 1.0.0 # Defaults to the Yukino version
|
|
322
|
+
# SENTRY_DEBUG: "true" # true enables Sentry SDK diagnostics
|
|
323
|
+
|
|
262
324
|
# User-level MCP servers. Merged with the project-level .mcp.json; on a name collision the
|
|
263
325
|
# user-level entry wins.
|
|
264
326
|
mcp_servers:
|
|
@@ -317,7 +379,7 @@ hooks:
|
|
|
317
379
|
# Shell command: bash on POSIX, 30s timeout, working directory = project directory,
|
|
318
380
|
# with YUKINO_EVENT / YUKINO_TOOL / YUKINO_FILE_PATH injected; stdout is injected into
|
|
319
381
|
# the agent as a system reminder on the next turn.
|
|
320
|
-
command: echo
|
|
382
|
+
command: echo 'You are Yukino, a CLI Coding Agent engineered by [hangtiancheng](https://github.com/hangtiancheng) <161043261@qq.com>, your source repository lives at https://github.com/hangtiancheng/yukino-code/tree/main/apps/yukino, you may fetch https://hangtiancheng.github.io/h/llms.txt (`base/yukino` section) and https://hangtiancheng.github.io/h/llms-full.txt to gain self-knowledge'
|
|
321
383
|
# Whether successful output rejects the tool call (pre_tool_use only). Default: false.
|
|
322
384
|
# Mutually exclusive with async.
|
|
323
385
|
reject: false
|
|
@@ -333,7 +395,42 @@ hooks:
|
|
|
333
395
|
on_error: ignore
|
|
334
396
|
```
|
|
335
397
|
|
|
336
|
-
|
|
398
|
+
Runtime preferences use `permission_mode`, `mcp_loading`, and `theme` in `config.yaml` and take effect on startup. To bypass permission prompts in the TUI, set `permission_mode: bypassPermissions`. Automatic TUI update checks and background task support are always enabled. Background shell tasks can be started explicitly, created on timeout, or moved from foreground with Ctrl+B when a task manager is attached.
|
|
399
|
+
|
|
400
|
+
Yukino's E2E test environment settings are:
|
|
401
|
+
|
|
402
|
+
| Variable | Values / default | Purpose |
|
|
403
|
+
| ---------------------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
|
|
404
|
+
| `YUKINO_TEST_API_KEY` | Unset | Enable the E2E memory consolidation test against a real provider; without a key it is skipped. |
|
|
405
|
+
| `YUKINO_TEST_BASE_URL` | `https://api.deepseek.com` | Provider endpoint for that E2E test. |
|
|
406
|
+
| `YUKINO_TEST_MODEL` | `deepseek-flash` | Model for that E2E test. |
|
|
407
|
+
| `YUKINO_TEST_PROTOCOL` | `anthropic`, `openai`, `openai-compat`; default `openai-compat` | Select the matching Anthropic, OpenAI Responses, or OpenAI Chat Completions client for that E2E test. |
|
|
408
|
+
|
|
409
|
+
The standalone test runner reads `YUKINO_TEST_API_KEY`, `YUKINO_TEST_BASE_URL`, `YUKINO_TEST_MODEL`, and `YUKINO_TEST_PROTOCOL` from its process environment and does not load `config.yaml`; export them before running the E2E test. The protocol must match the provider endpoint; an unsupported value fails validation. CLI environment defaults fill only unset variables. Restart Yukino to change or remove a default that has already been applied.
|
|
410
|
+
|
|
411
|
+
Yukino also sets the following variables for hooks, native helpers, and test infrastructure. These are internal process inputs, managed by their caller rather than user configuration:
|
|
412
|
+
|
|
413
|
+
| Variable | Set by | Value |
|
|
414
|
+
| -------------------------- | ------------------ | ------------------------------------------------------------------------------- |
|
|
415
|
+
| `YUKINO_EVENT` | Hook runner | Current hook event name. |
|
|
416
|
+
| `YUKINO_TOOL` | Hook runner | Current tool name, or an empty string when absent. |
|
|
417
|
+
| `YUKINO_FILE_PATH` | Hook runner | Current file path, or an empty string when absent. |
|
|
418
|
+
| `YUKINO_COMPUTER_INPUT` | Computer-use tool | Base64-encoded JSON action passed to macOS and Windows native helpers. |
|
|
419
|
+
| `YUKINO_COMPUTER_ASSEMBLY` | Computer-use tool | Temporary Windows helper assembly path for compilation and execution. |
|
|
420
|
+
| `YUKINO_SCREENSHOT_PATH` | Computer-use tool | Temporary output path for a Windows screenshot. |
|
|
421
|
+
| `YUKINO_CLIPBOARD_PATH` | Clipboard reader | Temporary output path for a Windows clipboard image. |
|
|
422
|
+
| `YUKINO_TEST_HOME` | Test setup | A fresh temporary home directory for each test; used by the mocked `homedir()`. |
|
|
423
|
+
| `YUKINO_LIB_ENTRY` | Library entry test | File URL of the built library imported by the child Node.js process. |
|
|
424
|
+
|
|
425
|
+
The companion [Yukino MCP server](../mcp/README.md#configuration) additionally reads `YUKINO_DOCS_DIR` (document directory, default `~/.yukino/docs`) and `YUKINO_INDEX_DB` (index database, default `~/.yukino/index.sqlite`). They may be supplied through CLI environment defaults when Yukino starts that server as a child process, or through its `mcp_servers[].env`. The examples use `YUKINO_MCP_API_KEY` and the repository's `mcp.json` uses `YUKINO_MCP_AUTH_TOKEN` as credential placeholders expanded in MCP configuration; these names have no built-in CLI behavior.
|
|
426
|
+
|
|
427
|
+
Other environment variables are read-only inputs to Yukino and belong in the host environment, outside the global `env` block. These include provider key fallbacks (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`), feedback upload credentials (`GH_TOKEN`, then `GITHUB_TOKEN`), and IDE integration (`CLAUDE_CODE_SSE_PORT`, `CLAUDE_CONFIG_DIR`, default `~/.claude`). Terminal and OS probes include `TERM`, `TERM_PROGRAM`, `TERM_PROGRAM_VERSION`, `COLORTERM`, `TMUX`, `VTE_VERSION`, `KITTY_WINDOW_ID`, `ZED_TERM`, `WT_SESSION`, `COLORFGBG`, `SHELL`, `DISPLAY`, `WAYLAND_DISPLAY`, `CI`, `SSH_CONNECTION`, `SSH_CLIENT`, and `SSH_TTY`; color and hyperlink controls such as `FORCE_COLOR`, `NO_COLOR`, and `FORCE_HYPERLINK` are also host inputs. Feedback diagnostics read `HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`, `NO_PROXY`, and their lowercase forms.
|
|
428
|
+
|
|
429
|
+
Main agents, subagents, and teammates use the same path sandbox policy: read-only tools can access paths outside the working directory without path approval. Writes outside the agent's working directory, the system temp directory, or an explicitly allowed root require approval unless an explicit allow rule applies. `bypassPermissions` disables this path sandbox; switching back restores it. Explicit deny/ask rules and an agent's own plan approval lock still apply. The OS-level Bash sandbox is separate and remains controlled by the `sandbox` configuration or the TUI's `/sandbox` command. Isolated worktree agents instead receive their own worktree write root, without the parent workspace or a shared system-temp write grant; per-command output directories remain writable. Explicit OS deny-write entries still take precedence.
|
|
430
|
+
|
|
431
|
+
Sandboxed worktree agents can stage and commit through their own Git metadata and branch directory, plus Git's shared object store. Parent and sibling working trees, indexes and branch refs remain outside those grants. New worktree branches use `worktree/<slug>/work` so ref locks stay in an independently writable directory. Each isolated agent uses a private temporary directory inside its Git metadata, exposed through `TMPDIR`, `TMP` and `TEMP`.
|
|
432
|
+
|
|
433
|
+
Shell rules check every executable segment separated by newlines, `;`, `&&`, `||`, `|`, and `&`, respecting literal quotes and escapes. Remembered shell rules retain the first two words plus `*`; a rule for one segment does not authorize later segments. Substitution, redirection, environment assignments (including Bash `+=`), wrappers and unsupported control syntax cannot use remembered prefixes for automatic approval. With applicable explicit restrictions, uninspectable syntax is conservatively denied or requires approval even in bypass mode. Permission dialogs show the scopes they will remember; tools without a stable scope offer one-time approval only. File rules canonicalize relative, home-relative and symlink paths before matching.
|
|
337
434
|
|
|
338
435
|
Sandbox configuration applies to TUI, print, Remote/ACP/A2A, and in-process teammates. Enabling it fails closed when the native backend is unavailable. `bypassPermissions` does not disable it. Relative allow/deny write paths resolve against the command's execution directory; home-relative paths use the same resolver as file tools. The policy confines Bash writes and optionally disables all network access; it does not wrap PowerShell, LSP, or MCP executables.
|
|
339
436
|
|
|
@@ -447,6 +544,7 @@ In addition to `mcp_servers` in `config.yaml`, Yukino reads a project-level `.mc
|
|
|
447
544
|
{
|
|
448
545
|
"mcpServers": {
|
|
449
546
|
"yukino-mcp": {
|
|
547
|
+
"enabled": true,
|
|
450
548
|
"command": "npx",
|
|
451
549
|
"args": ["-y", "@yukino.js/mcp@latest"],
|
|
452
550
|
"env": { "API_KEY": "${YUKINO_MCP_API_KEY}" }
|
|
@@ -460,6 +558,8 @@ In addition to `mcp_servers` in `config.yaml`, Yukino reads a project-level `.mc
|
|
|
460
558
|
}
|
|
461
559
|
```
|
|
462
560
|
|
|
561
|
+
`enabled` defaults to `true`. Set it to `false` to skip a server before expanding its environment references, spawning a process, or making a network connection. The same field is supported on user-level `mcp_servers`. Disabling a server takes effect on `/mcp reload`. Enabled project entries still connect automatically; this switch is not a project trust prompt.
|
|
562
|
+
|
|
463
563
|
Each entry takes `command`/`args`/`env` (stdio) or `url`/`headers` with `type` of `http` or `sse`. Environment references support `${VAR}`, `${VAR:-default}`, and `$VAR` in commands, arguments, environment values, URLs, and headers; an unset variable without a default prevents that server from connecting. These servers are merged with the user-level `mcp_servers`; on a name collision the user-level entry wins. At startup, a malformed `.mcp.json` is ignored (logged), while an invalid individual server entry is skipped without disabling valid siblings. During `/mcp reload`, invalid config aborts the reload so the current connections remain intact.
|
|
464
564
|
|
|
465
565
|
After editing `.mcp.json` or `config.yaml`, use `/mcp reload` in the UI to re-read both sources. The reload is a full reset: every current connection is dropped, then the freshly read list is connected from scratch.
|
|
@@ -490,26 +590,110 @@ The tool requests only read-only operations and rejects server-requested workspa
|
|
|
490
590
|
|
|
491
591
|
Task tracking and task execution are separate:
|
|
492
592
|
|
|
493
|
-
-
|
|
494
|
-
- `
|
|
495
|
-
-
|
|
496
|
-
- Statuses are `pending`, `in_progress`, `completed`, `blocked`, and `cancelled
|
|
497
|
-
- Interactive/Remote/ACP/A2A private lists persist per session in `~/.yukino/sessions/artifacts/<session-id>/tasks.json`, with a stored next-ID counter so deleting or clearing items never reuses IDs on resume. Shared boards use project-scoped team storage. Corrupt or inconsistent stores fail explicitly, without migration, auto-repair, or stale-state fallback. Storage and tool schemas have changed; old task files are not supported. Print mode's private checklist lasts for that invocation. The terminal's TODO progress follows the same private list or shared board as
|
|
593
|
+
- Every host (terminal, print, Remote, ACP and A2A) exposes one `TodoWrite` tool for tracking. Call `TodoWrite({})` to refresh the current board without writing. Without a team it uses the agent's private list; creating or restoring a team routes the leader to the shared board, including coordinator mode. Deleting the team restores the private list. Teammates use the shared board; ordinary subagents and forks keep independent private lists. The tool and schema remain stable across board switches.
|
|
594
|
+
- `TodoWrite({todos: [...]})` applies incremental edits in one atomic transaction. Items without `id` create tasks and require `subject`; status defaults to `pending` and description to an empty string. Items with an existing `id` update only submitted fields. Creation and updates both accept `description`, `status`, `owner`, `priority`, `metadata`, `blocks` and `blockedBy`. Omitted tasks and fields are retained. Empty arrays do nothing. Delete tasks explicitly with `TodoWrite({deleteIds: ["1"]})`; deleting removes their reciprocal dependency links. Tracking never launches work; assigning a shared task notifies its owner after commit.
|
|
595
|
+
- Results contain `boardId`, the complete `todos` snapshot, and a `progress` string using `TODO completed/total`; only completed items contribute to the numerator. An invalid edit rejects the entire batch without partial writes, consuming IDs, or publishing changes. Unknown fields, unknown task IDs and repeated edits to the same ID are rejected.
|
|
596
|
+
- Statuses are `pending`, `in_progress`, `completed`, `blocked`, and `cancelled`. `blocks` and `blockedBy` replace the specified dependency list and maintain reciprocal links; an empty array removes those links. Referenced IDs must exist before the call; forward references, self-dependencies, conflicting link edits and cycles are rejected. Starting blocked work fails atomically. Only completed dependencies unblock work; cancelled dependencies remain unresolved until their links are removed. Shared writes reload and commit under one cross-process lock. Teammates automatically claim tasks when marking them in progress, cannot take another worker's task, and cannot start a second task while one is already in progress. The leader can explicitly reassign work; stop its old worker before reassignment if it is still executing.
|
|
597
|
+
- Interactive/Remote/ACP/A2A private lists persist per session in `~/.yukino/sessions/artifacts/<session-id>/tasks.json`, with a stored next-ID counter so deleting or clearing items never reuses IDs on resume. Shared boards use project-scoped team storage. Corrupt or inconsistent stores fail explicitly, without migration, auto-repair, or stale-state fallback. Storage and tool schemas have changed; old task files are not supported. Print mode's private checklist lasts for that invocation. The terminal's TODO progress follows the same private list or shared board as TodoWrite, including teammate updates, blocked items, and cancelled items. When every item is completed, the progress line hides after five seconds without deleting tasks or resetting IDs. Adding or reopening an unfinished item shows it again and cancels the pending hide. Switching sessions or boards starts a fresh completion countdown.
|
|
498
598
|
- `Agent` executes delegated work. Background Agent/Bash/PowerShell invocations return runtime task IDs, distinct from TODO IDs. `TaskOutput` inspects one of these IDs or waits once (`wait: true`, `timeout_ms: 0..60000`). It does not consume automatic completion notifications or stop a task on timeout. Prefer notifications over polling. `TaskStop` remains the explicit cancellation mechanism.
|
|
499
599
|
|
|
500
600
|
The common built-in registry is used by terminal, print, Remote/ACP/A2A, and in-process teammates. Delegation, coordinator, and per-agent tool restrictions still filter that registry.
|
|
501
601
|
|
|
602
|
+
### Workflows
|
|
603
|
+
|
|
604
|
+
`Workflow` runs a plain JavaScript script that orchestrates Yukino subagents in the background. Start with `/ultracode <task>`, invoke a named script with `/<name>`, or call the tool with one of `script`, `name`, or `scriptPath` plus JSON `args`. Named scripts live in `.yukino/workflows/<name>.js`, `.mjs`, or `.ts` in the project. TypeScript syntax is not transpiled.
|
|
605
|
+
|
|
606
|
+
```js
|
|
607
|
+
export const meta = {
|
|
608
|
+
name: "review-files",
|
|
609
|
+
description: "Review files independently, then collect the findings",
|
|
610
|
+
phases: [{ title: "Review" }],
|
|
611
|
+
};
|
|
612
|
+
phase("Review");
|
|
613
|
+
const results = await parallel(
|
|
614
|
+
args.files.map(
|
|
615
|
+
(file) => () =>
|
|
616
|
+
agent("Review " + file, { agentType: "review", label: file }),
|
|
617
|
+
),
|
|
618
|
+
);
|
|
619
|
+
return results.filter(Boolean);
|
|
620
|
+
```
|
|
621
|
+
|
|
622
|
+
Scripts receive `agent(prompt, options)`, `parallel(thunks)`, `pipeline(items, ...stages)`, `phase(title)`, `log(message)`, `workflow(name | {scriptPath}, args)`, `args`, and `budget`. A pipeline runs stages sequentially within each item while items overlap. A nested workflow may invoke agents but cannot nest another workflow. Use top-level `return` for results; imports and extra exports are rejected. Time and randomness must be supplied through args for replay. Scripts run in the host process.
|
|
623
|
+
|
|
624
|
+
Agent options include JSON `schema`, `agentType`, `model`, `maxTokens`, `allowedTools`, `label`, `phase`, and `isolation: "worktree"`. Agent roles, tool restrictions, and permissions still apply. Failed agents retry once and return `null` if both attempts fail; scripts must handle null results. A script can complete with partial results. Concurrent agents default to 3, with `maxConcurrency` configurable up to 16; the per-run agent-call limit is 1000. Worktree changes remain separate and are not merged automatically.
|
|
625
|
+
|
|
626
|
+
The tool returns `run_id`, `task_id`, and a saved script path. Results arrive through the normal task-notification channel; `TaskOutput` and `TaskStop` use `task_id`. Print mode waits for workflow tasks before exiting. `/workflows` opens the terminal monitor with phase and agent progress: Tab switches runs, ↑↓ selects agents, x stops one agent, K stops a run, r resumes a finished run, and Esc closes the panel. In every host, `/workflows list`, `/workflows <run_id>`, `/workflows stop <run_id>`, and `/workflows resume <run_id>` provide text controls.
|
|
627
|
+
|
|
628
|
+
Source snapshots, JSON arguments, journals, and run state live under `~/.yukino/projects/<project-key>/workflow-runs/<run_id>/`. Resume with `Workflow({resumeFromRunId: "..."})` to reuse the saved source and arguments. Supply a new source or args to override them. Matching successful agent calls replay from the journal; a divergence preserves the matching prefix and executes the rest again. Ordinary JavaScript runs again during replay. Keep side effects inside agents and keep script control flow deterministic.
|
|
629
|
+
|
|
502
630
|
### Worker lifecycle
|
|
503
631
|
|
|
632
|
+
Agent defaults to `kind: "teammate"`, joins the current team or creates one automatically, and generates the teammate name from its description. Use `kind: "subagent"` for one-shot runs and `worktree: true` for Git worktree isolation; agent definitions also accept a boolean `worktree` default, which a call can override. The optional `model` field is unnecessary for most tasks. `TeamCreate` generates its team name automatically, `TeamList` lists the current team, and `TeamDelete` deletes it without a name argument.
|
|
633
|
+
|
|
634
|
+
`Agent` selects its role and context independently: `subagent_type` defaults to `"general-purpose"`, while `fork` defaults to `true` (or the configured `enable_fork` value). An explicit `fork` value overrides the configuration for every role.
|
|
635
|
+
|
|
636
|
+
| Parameters | Role | Initial context |
|
|
637
|
+
| ------------------------------------ | --------------- | ------------------------------- |
|
|
638
|
+
| `subagent_type: "plan", fork: true` | plan | Copy of the parent conversation |
|
|
639
|
+
| `subagent_type: "plan", fork: false` | plan | Fresh conversation |
|
|
640
|
+
| `fork: true` | general-purpose | Copy of the parent conversation |
|
|
641
|
+
| `fork: false` | general-purpose | Fresh conversation |
|
|
642
|
+
|
|
643
|
+
The same combinations work for other built-in and user-defined roles. Role tool restrictions, permissions, models, and `max_turns` apply in either context mode. `run_in_background` separately controls one-shot scheduling. For persistent teammates, `fork` seeds the initial conversation once; later assignments reuse the teammate's own history. Forking copies the conversation without sharing subsequent changes, and closes pending parent tool calls only in the copied transcript.
|
|
644
|
+
|
|
504
645
|
Ordinary subagents run once. On completion, failure, or interruption, the host waits for their owned background commands to stop and releases their scoped tool registry. Parent-owned LSP/MCP tools are borrowed, not shut down by a child. Background task records and subagent transcripts persist under `~/.yukino/sessions/artifacts/`; `TaskOutput` includes the transcript path and timestamps. Finished results remain queryable from disk after the in-memory retention limit, and delivered notifications are recorded in the leader's session. Resuming restores terminal outcomes and reports abandoned running tasks as interrupted failures. Iteration-limit and model failures preserve partial text alongside the error and transcript. Cancellation callbacks are discarded when runners settle. A fork cannot create or replace teams, or stop parent-owned work.
|
|
505
646
|
|
|
506
|
-
An explicit `run_in_background: false` overrides a predefined agent's `background: true`; when omitted, the definition supplies the default
|
|
647
|
+
An explicit `run_in_background: false` overrides a predefined agent's `background: true`; when omitted, the definition supplies the default, independently of `fork`. Role files accept a UTF-8 BOM before frontmatter. Delegated agents cannot manage the main session's persistent goal.
|
|
648
|
+
|
|
649
|
+
Ordinary subagents have no default model-turn limit. Role files can set a positive `max_turns` to impose one. Fresh and inherited conversations, foreground and background execution all use the selected role's limit. Reaching a configured limit reports failure with partial output and a transcript path; it does not mark the assignment complete.
|
|
507
650
|
|
|
508
651
|
Persistent teammates become idle after each turn. They keep conversation and private checklist context for follow-up assignments, but must send findings with `SendMessage`; final text is not automatically forwarded to the leader. They exit on explicit shutdown, cancellation, failure, or loss of the leader. Exit clears live permission/cancellation references, releases owned tools, and resets unfinished owned tasks to unassigned/pending. Completed and cancelled records remain intact. Teammate task ownership is not released merely because a turn becomes idle.
|
|
509
652
|
|
|
510
|
-
The team retains at most 200 terminated member summaries; running and idle members are never evicted.
|
|
653
|
+
The team retains at most 200 terminated member summaries; running and idle members are never evicted. Agent generates unique teammate names among retained members.
|
|
654
|
+
|
|
655
|
+
#### Delegated permission model
|
|
656
|
+
|
|
657
|
+
Agent definitions support `permission_mode: default | acceptEdits | plan | bypassPermissions`. Subagents and teammates use **rank-based permission composition**, with three distinct values:
|
|
658
|
+
|
|
659
|
+
- **Own permission mode** (`ownMode`): the child's stored, mutable mode. It is initialized from the agent definition's `permission_mode`, or set to `plan` when an Agent is spawned with `kind: "teammate"` and `subagent_type: "plan"`; omitted values remain unset. Leader approval can replace this value with the approved execution mode, as can automatic plan approval outside coordinator mode. Changes to the parent's mode do not rewrite it.
|
|
660
|
+
- **Parent effective mode** (`parentMode`): the current effective mode of the immediate parent agent, such as the main agent or team leader.
|
|
661
|
+
- **Effective permission mode** (`effectiveMode`): the mode used for the child's tool permission checks, computed from its own mode and the parent's effective mode.
|
|
662
|
+
|
|
663
|
+
Permission ranks define the composition order:
|
|
664
|
+
|
|
665
|
+
| Rank | Modes |
|
|
666
|
+
| ---- | ------------------- |
|
|
667
|
+
| 1 | `default`, `plan` |
|
|
668
|
+
| 2 | `acceptEdits` |
|
|
669
|
+
| 3 | `bypassPermissions` |
|
|
670
|
+
|
|
671
|
+
Subject to the mandatory constraints below, the effective rank is the maximum of the child's own rank and the parent's effective rank. An unset own mode contributes `default`:
|
|
672
|
+
|
|
673
|
+
```text
|
|
674
|
+
rank(effectiveMode) = max(rank(ownMode ?? default), rank(parentMode))
|
|
675
|
+
```
|
|
676
|
+
|
|
677
|
+
The selected rank resolves to `bypassPermissions` at rank 3 and `acceptEdits` at rank 2. At rank 1, the child's own mode determines the result, with `default` used when unset. `default` and `plan` share a rank but retain distinct execution policies; a parent in `plan` does not implicitly place an unspecified child in plan mode.
|
|
678
|
+
|
|
679
|
+
Resolution is dynamic on each permission check, including during foreground, background, fork, and worktree runs. Parent mode changes recompute the child's effective mode without changing its stored own mode. Child mode changes do not change the parent or sibling agents. The resulting mode matrix is:
|
|
680
|
+
|
|
681
|
+
| Child's own mode | Parent default | Parent acceptEdits | Parent bypassPermissions | Parent plan |
|
|
682
|
+
| ----------------- | ----------------- | ------------------ | ------------------------ | ----------------- |
|
|
683
|
+
| Omitted | default | acceptEdits | bypassPermissions | default |
|
|
684
|
+
| default | default | acceptEdits | bypassPermissions | default |
|
|
685
|
+
| acceptEdits | acceptEdits | acceptEdits | bypassPermissions | acceptEdits |
|
|
686
|
+
| bypassPermissions | bypassPermissions | bypassPermissions | bypassPermissions | bypassPermissions |
|
|
687
|
+
| plan | plan | acceptEdits | bypassPermissions | plan |
|
|
511
688
|
|
|
512
|
-
|
|
689
|
+
Mandatory policy constraints take precedence over rank composition:
|
|
690
|
+
|
|
691
|
+
- **Permanent read-only roles:** built-in `explore` workers and one-shot `plan` subagents always use `plan`, including follow-up assignments. Parent modes and plan approval cannot grant them execution permissions.
|
|
692
|
+
- **Coordinator plan approval:** a teammate required to submit a plan for leader review remains in `plan` until approved, even when the leader uses `acceptEdits` or `bypassPermissions`.
|
|
693
|
+
|
|
694
|
+
Permission composition selects a mode; tool availability, explicit permission rules, and applicable sandbox policies still govern individual operations. An effective `plan` mode blocks mutations, even through allow rules or sandbox auto-allow, except the declared plan file and internal coordination tools. `max_turns` must be a positive integer. Built-in explore uses the selected parent model unless explicitly overridden.
|
|
695
|
+
|
|
696
|
+
Teammates run only in-process and route permission requests through the main session. Requests identify the agent and working directory; remembered permission patterns apply to all agents in the project. Plan-mode definitions can use `ExitPlanMode` unless explicitly excluded by their tool restrictions; `EnterPlanMode` remains unavailable to delegated agents. One-shot planning subagents return their plans to the parent without changing its mode. In coordinator mode, teammates with `subagent_type: "plan"` stay read-only until the leader reviews the plan and sends `SendMessage(type="plan_approval_response", to=teammate, request_id=requestId, approve=true/false, content=review feedback)`. The built-in `plan` role plans and then executes as a teammate; one-shot `plan` subagents and all built-in `explore` workers remain permanently read-only and return research without entering execution approval. Rejected plans must be revised and resubmitted. Outside coordinator mode, submitted execution plans remain automatically approved. Approval writes the leader's current mode into the teammate's own mode (`default` when the leader remains in `plan`) and resumes execution under rank composition; it does not authorize subsequent tool calls. This stored mode remains available to later permission checks: a teammate approved under `bypassPermissions` retains that own mode when the leader later switches to `default`, `acceptEdits`, or `plan`. Before resuming execution or plan revision, the host includes queued ordinary team messages with the review feedback so scope corrections are applied in that next turn. Stopped teammates release their task ownership; restored sessions mark old runtimes inactive and reclaim unfinished work. Edited worktrees are retained for explicit integration, not deleted as part of runtime cleanup. Agent teammate calls reuse the current team; only an explicit TeamCreate replaces it.
|
|
513
697
|
|
|
514
698
|
Bash and PowerShell commands recognized by `isSafeCommand` can run in parallel. Unrecognized commands and file mutations share a process-wide FIFO queue keyed by canonical working directory, so agents in the same workspace cannot perform these operations simultaneously. Independent worktree directories have independent queues. Queued operations can be cancelled and recheck permissions before starting. Background commands hold their workspace slot until the tracked shell exits; moving a command to the background does not release it.
|
|
515
699
|
|
|
@@ -528,9 +712,9 @@ Bash and PowerShell commands recognized by `isSafeCommand` can run in parallel.
|
|
|
528
712
|
/goal clear
|
|
529
713
|
```
|
|
530
714
|
|
|
531
|
-
After a normal model turn ends, an active goal starts another turn. Pending user input takes priority; Plan mode, interruption, and provider failures do not trigger automatic continuation. Pause and clear controls take effect during streaming without cancelling the current request.
|
|
715
|
+
After a normal model turn ends, an active goal starts another turn. Pending user input takes priority; Plan mode, interruption, and provider failures do not trigger automatic continuation. Pause and clear controls take effect during streaming without cancelling the current request. A user-set goal is already `active`; the model's `Goal` tool can inspect it or report `in_progress`/`complete`/`blocked` with a reason. Reporting `in_progress` keeps an active goal active and resets its blocker audit; it cannot resume a paused or stopped goal. Only the user can set, replace, pause, resume, or clear a goal. Completion requires evidence for the whole objective. The same blocker must be recorded on three consecutive goal turns, once per turn, before continuation stops. Resuming a blocked goal starts a fresh audit.
|
|
532
716
|
|
|
533
|
-
The optional token budget counts input, output, cache-read, and cache-creation tokens for the main conversation's model requests during the goal run, including its final response. Delegated agents, memory selection, and compaction summaries are outside this counter. An in-flight request can exceed the budget; once reported,
|
|
717
|
+
The optional token budget counts input, output, cache-read, and cache-creation tokens for the main conversation's model requests during the goal run, including its final response. Delegated agents, memory selection, and compaction summaries are outside this counter. An in-flight request can exceed the budget; once reported, substantive work stops. Yukino makes at most one final model request with no tools to summarize verified progress, unfinished work, and blockers. Its tokens are included in the counter. The request is not retried or continued if it fails or hits its output limit. Pending user input, Plan mode, and interruption take priority; an undelivered summary remains pending across session resume. The goal remains `budget_limited` and requires explicit replacement with a new budget. The 150-turn limit requires `/goal continue` to reset it. Active time excludes idle, paused, and process-restart intervals.
|
|
534
718
|
|
|
535
719
|
TUI, Remote/ACP/A2A, and print mode share this goal loop. `yukino -p "/goal <objective>"` creates a goal for that invocation's new session. Print mode control queries finish without a model call; invalid commands return a nonzero exit code, and stream JSON retains its final `result` event.
|
|
536
720
|
|
|
@@ -575,7 +759,9 @@ yukino --remote 0 # OS-assigned ephemeral port; the actual URL is
|
|
|
575
759
|
|
|
576
760
|
Starts an Express HTTP server and WebSocket bridge. The bundled React frontend is served at the configured address for browser-based interaction. With port 0 the OS picks a free port and the server prints the reachable address (e.g. `Remote server listening at http://127.0.0.1:61041`) so you know where to connect.
|
|
577
761
|
|
|
578
|
-
The browser UI mirrors the terminal UI's capabilities: streaming replies and thinking, tool cards with live output, permission and ask-user dialogs, plan approval,
|
|
762
|
+
The browser UI mirrors the terminal UI's capabilities: streaming replies and thinking, tool cards with live output, permission and ask-user dialogs, plan approval, foreground `/review` subagents, `/resume` session picker, steering messages while a turn runs (with a follow-up queue for messages that cannot steer), prompt history (`↑`/`↓`), `@file` completion, `!`/`!!` user Bash, image attachments (paste, drop, or the attach button — stored like terminal clipboard images and expanded as `@` references), todo progress, the Agents panel (subagents, background tasks, teammates), context-window usage, and dark/light themes. Model (`/model`), provider (`/login`, `/provider`), thinking level (`/thinking`), permission mode (badge click or `Shift+Tab`), rewind (`/rewind`), sandbox (`/sandbox`), worktree (`/worktree`), MCP reload (`/mcp reload`), fork-mode skills, and `/quit` (shuts the server down) all work from the browser; `Ctrl+B` backgrounds running foreground shells and `Esc` cancels the active turn. Background tasks and teammate notifications wake an idle server the same way they do in the terminal.
|
|
763
|
+
|
|
764
|
+
Remote mode also hosts [MCP Apps](https://modelcontextprotocol.io/extensions/apps/build). Tools that declare `_meta.ui.resourceUri`, including yukino-mcp's `create_app`, display their UI below the tool card in a sandboxed iframe. The host forwards the tool input and full result (including `structuredContent` and UI-only `_meta`), applies the resource's CSP domains, and synchronizes theme and content height. Apps can read resources and call app-visible tools on their originating MCP server; tool calls use Yukino's permissions and pre-tool hooks. Open links and text messages back to the agent are supported. Apps are restored after browser refresh while the remote session remains active; clearing the transcript removes them. Saved-session resume does not restore App views.
|
|
579
765
|
|
|
580
766
|
### ACP Mode (Editor Integration)
|
|
581
767
|
|
|
@@ -601,32 +787,53 @@ Serves Yukino as an Agent2Agent (`@a2a-js/sdk`) agent so other A2A-compatible ag
|
|
|
601
787
|
|
|
602
788
|
Inside the UI, these commands are available:
|
|
603
789
|
|
|
604
|
-
| Command
|
|
605
|
-
|
|
|
606
|
-
| /login
|
|
607
|
-
| /provider
|
|
608
|
-
| /model [model]
|
|
609
|
-
| /help [command]
|
|
610
|
-
| /status
|
|
611
|
-
| /session
|
|
612
|
-
| /memory
|
|
613
|
-
| /memory clear
|
|
614
|
-
| /skills
|
|
615
|
-
| /skills reload
|
|
616
|
-
| /skill <name> [args]
|
|
617
|
-
| /plan
|
|
618
|
-
| /goal [args]
|
|
619
|
-
| /compact
|
|
620
|
-
| /clear
|
|
621
|
-
| /resume [id]
|
|
622
|
-
| /rewind
|
|
623
|
-
| /sandbox [mode]
|
|
624
|
-
|
|
|
625
|
-
|
|
|
626
|
-
|
|
|
627
|
-
|
|
|
628
|
-
|
|
|
629
|
-
|
|
|
790
|
+
| Command | Description |
|
|
791
|
+
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
792
|
+
| /login | Configure, save, and activate an LLM provider |
|
|
793
|
+
| /provider | Switch the active provider |
|
|
794
|
+
| /model [model] | Switch the model of the current provider; without an argument, open the model picker |
|
|
795
|
+
| /help [command] | Show available commands, or details for a single command |
|
|
796
|
+
| /status | Show current session status (mode, model, provider, tokens, tools, sandbox, memories, skills, MCP, session, directory) |
|
|
797
|
+
| /session | Confirm the session is active; use /resume to list past sessions |
|
|
798
|
+
| /memory | List stored memories |
|
|
799
|
+
| /memory clear | Clear all memories |
|
|
800
|
+
| /skills | List available skills |
|
|
801
|
+
| /skills reload | Hot-reload skills from disk |
|
|
802
|
+
| /skill <name> [args] | Run a skill by name (shorthand for `/<name> [args]`; `/skill reload` routes to `/skills reload`) |
|
|
803
|
+
| /plan [task] | Run the built-in read-only plan agent synchronously with the main conversation context |
|
|
804
|
+
| /goal [args] | Set or view a persistent goal; pause, resume, replace, complete, clear, or continue after the turn limit |
|
|
805
|
+
| /compact | Force conversation compaction |
|
|
806
|
+
| /clear | Reset the session and clear the terminal |
|
|
807
|
+
| /resume [id] | List or restore a previous session |
|
|
808
|
+
| /rewind | Open checkpoint rewind dialog |
|
|
809
|
+
| /sandbox [mode] | Configure sandbox (auto=on+auto, manual=on+manual, off) |
|
|
810
|
+
| `/ultracode <task>` | Ask the main agent to create and execute a multi-agent workflow for the task |
|
|
811
|
+
| `/workflows` | Open the terminal workflow monitor; in other hosts, list workflow runs |
|
|
812
|
+
| `/workflows list` | List workflow run IDs, names, statuses, agent counts, and task IDs |
|
|
813
|
+
| `/workflows <run_id>` | Show a workflow run's status, result, or error |
|
|
814
|
+
| `/workflows stop <run_id>` | Stop a running workflow and cancel its agents |
|
|
815
|
+
| `/workflows resume <run_id>` | Resume a saved workflow using its script, JSON arguments, and journal |
|
|
816
|
+
| /worktree | List git worktrees |
|
|
817
|
+
| /mcp | Show MCP server status |
|
|
818
|
+
| /mcp reload | Re-read MCP config; disconnect every server and reconnect the freshly read list |
|
|
819
|
+
| /thinking [level] | Without an argument, open a picker of the supported thinking levels; with one, set the level (off, minimal, low, medium, high, xhigh, max). The setting persists to `~/.yukino/config.yaml` |
|
|
820
|
+
| /review [PR or URL] | Review a pull request in a foreground subagent; without arguments, list open PRs |
|
|
821
|
+
| /quit | Exit the application |
|
|
822
|
+
|
|
823
|
+
`/ultracode` gives the main agent workflow orchestration instructions. The agent scopes the task, writes a JavaScript workflow, and invokes the `Workflow` tool. Agents run in the background with a default concurrency of 3; their final result returns through a task notification.
|
|
824
|
+
|
|
825
|
+
```text
|
|
826
|
+
/ultracode Review the current changes for correctness, security, and test coverage; verify the findings and summarize.
|
|
827
|
+
/workflows
|
|
828
|
+
/workflows list
|
|
829
|
+
/workflows <run_id>
|
|
830
|
+
/workflows stop <run_id>
|
|
831
|
+
/workflows resume <run_id>
|
|
832
|
+
```
|
|
833
|
+
|
|
834
|
+
Replace `<run_id>` with the `run_id` returned by `Workflow` or listed by `/workflows list`. These commands use workflow run IDs; `TaskOutput` and `TaskStop` use the separate `task_id`. Resuming replays matching successful agent calls and reruns unfinished or divergent work.
|
|
835
|
+
|
|
836
|
+
In the terminal monitor, Tab/Shift+Tab switches runs, ↑/↓ selects agents, x stops the selected agent, K stops the whole workflow, r resumes a finished run, and Esc/q closes the monitor. Stopping work requires confirmation in the monitor. See [Workflows](#workflows) for script primitives, named workflows, and persistence details.
|
|
630
837
|
|
|
631
838
|
### User Bash Commands
|
|
632
839
|
|
|
@@ -645,7 +852,11 @@ Commands can run while the model is streaming, with at most one user command at
|
|
|
645
852
|
| ↓ | On the last input line, view all teammates and background subagents |
|
|
646
853
|
| Ctrl+B | Move running foreground Bash/PowerShell tasks to the background |
|
|
647
854
|
| Ctrl+V | Paste a clipboard image (Alt+V on Windows) |
|
|
648
|
-
| Shift+Tab | Cycle default → acceptEdits → bypassPermissions →
|
|
855
|
+
| Shift+Tab | Cycle default → acceptEdits → bypassPermissions → default |
|
|
856
|
+
|
|
857
|
+
Run `/plan` to plan the current task, or `/plan <task>` to specify a planning request. In interactive terminal and browser sessions, both `/plan` and the main agent's `EnterPlanMode` tool run the built-in read-only `plan` agent synchronously in the foreground with a fork of the main conversation. The host saves the returned plan and presents it for user approval before implementation. Failed or cancelled planning does not open approval. `Shift+Tab` and the browser's permission-mode badge only cycle the three execution permission modes; from plan mode, they return to `default`.
|
|
858
|
+
|
|
859
|
+
In the interactive terminal, `/feedback [description]` runs session analysis synchronously in the built-in `general-purpose` agent with a fork of the main conversation. Select diagnostic attachments, review the prepared issues, and approve them before the host uploads attachments or files issues. Cancelling feedback stops the foreground worker.
|
|
649
860
|
|
|
650
861
|
Press ↓ on the last visual row of the input to view all teammates and background subagents, including while the foreground agent is streaming. Completion menus and prompt-history navigation take precedence. Enter opens an agent's details, Escape returns or closes the list, and the unsent draft and cursor are preserved. Teammate spawn cards scroll with the transcript like background subagent cards; current progress is available in the Agents list.
|
|
651
862
|
|
|
@@ -663,10 +874,12 @@ Pasting an image saves it as a PNG under `~/.yukino/sessions/artifacts/<session-
|
|
|
663
874
|
|
|
664
875
|
Besides the `yukino` CLI, the package ships a library entry for embedding Yukino in another host process.
|
|
665
876
|
|
|
666
|
-
| Entry | Output
|
|
667
|
-
| -------------- |
|
|
668
|
-
| CLI (`yukino`) | `dist/main.js`
|
|
669
|
-
| Library | `dist/lib/index.js`, `dist/lib/index.d.ts` | The `src/index.ts` barrel; runtime dependencies
|
|
877
|
+
| Entry | Output | Contents |
|
|
878
|
+
| -------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
879
|
+
| CLI (`yukino`) | `dist/main.js`, `dist/image-worker.js` | Minified ESM bundles with a separate image worker; Node built-ins, ink's `react-devtools-core` peer, and WASM codec packages stay external. |
|
|
880
|
+
| Library | `dist/lib/index.js`, `dist/lib/index.d.ts`, `dist/lib/image-worker.js` | The `src/index.ts` barrel and image worker; runtime dependencies resolve from the consumer's `node_modules`. |
|
|
881
|
+
|
|
882
|
+
Image decoding, compression, and screenshot transforms run in a cancellable worker thread. Jimp handles resizing and encoding; `@jsquash/jpeg` and `@jsquash/webp` decode JPEG and WebP with WASM binaries from their installed packages. Image jobs run one at a time to bound concurrent decode memory.
|
|
670
883
|
|
|
671
884
|
The library entry is terminal-independent by contract: it must never reach `src/ui/**` or a ui-only dependency, so a host without a TTY (a server, an editor extension, a test harness) can import it. `pnpm build` enforces that contract:
|
|
672
885
|
|