Skip to content

Commit 8a248d9

Browse files
committed
docs: reorganize CLI Misc Notes section into structured categories
1 parent e141933 commit 8a248d9

File tree

1 file changed

+0
-16
lines changed

1 file changed

+0
-16
lines changed

knowledge.md

Lines changed: 0 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -50,22 +50,6 @@ Codebuff is a tool for editing codebases via natural language instruction to Buf
5050
- Generator functions execute in secure QuickJS sandbox for safety
5151
- Both types integrate seamlessly through the same tool execution system
5252

53-
## CLI Interface Features
54-
55-
- ESC key to toggle menu or stop AI response
56-
- CTRL+C to exit the application
57-
58-
### CLI Toggle Rendering Notes
59-
60-
- The agent/tool toggles in the TUI render inside `<text>` components from OpenTUI. Any expanded content must resolve to plain strings or StyledText-compatible fragments (`<span>`, `<strong>`, `<em>`, etc.) so the reconciler can convert them into `TextNodeRenderable` instances.
61-
- Issue: When markdown-rendered content returned arbitrary React elements (e.g., nested `<box>` containers) under `<text>`, toggling a branch threw `Error: TextNodeRenderable only accepts strings, TextNodeRenderable instances, or StyledText instances`.
62-
- Fix (Oct 2025): `cli/src/components/branch-item.tsx` now inspects expanded content; if it is text-renderable, it stays inside `<text>`, otherwise the raw element tree is rendered directly. This prevents invalid children from reaching `TextNodeRenderable` while preserving formatted markdown.
63-
- Related adjustment: `cli/src/hooks/use-message-renderer.tsx` ensures the toggle header renders within a single `<text>` block so glyphs and names remain StyledText-safe.
64-
- Toggling any agent/tool branch now calls `scrollToAgent`, and each branch registers its container via `registerAgentRef`. This keeps the toggled item anchored in the top third of the scrollbox, improving navigation in long sessions.
65-
- Typing `/` now opens a five-item slash menu (mirroring npm-app commands) directly above the input. Use arrow keys or Tab/Shift+Tab to move the highlight and Enter to insert the selected command; the list scrolls as you move beyond the first five items.
66-
- Typing `@` scans the local `.agents` directory, surfaces agent `displayName`s (e.g., `@Codebase Commands Explorer`), and inserts the highlighted agent mention with Enter. Navigation mirrors the slash menu, and both menus cap the visible list at five entries.
67-
- Streaming markdown now renders as plain text until the message or agent finishes, preventing scroll jitter that occurred when partial formatting changed line heights mid-stream.
68-
6953
### Shell Shims (Direct Commands)
7054

7155
Codebuff supports shell shims for direct command invocation without the `codebuff` prefix.

0 commit comments

Comments
 (0)