Files
claude-code/packages/@ant/ink/docs/README.md
claude-code-best 2fb1c9dcd8 feat: 工具层及 mcp 大重构 (#252)
* feat: 第一版大重构

* fix: 修复类型问题

* chore: 更新版本到 1.3.2

* Add brave as alternative WebSearchTool

* fix: 修正顺序

* fix: 修复对穷鬼模式的 auto dream 和 session memory 越过

* feat: 穷鬼模式去除 session-summary

* feat: 创建 builtin-tools 包,搬运所有工具实现

将 src/tools/ 下的全部 60 个工具目录迁移至 packages/builtin-tools/src/tools/,
内部导入路径已更新为 src/ alias 模式。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* refactor: 更新 src/ 中所有工具引用至 builtin-tools 包,删除 src/tools/

- src/tools.ts 及 178 个 src/ 文件的 import 路径从 ./tools/ 改为 builtin-tools/tools/
- 删除 src/tools/ 整个目录(已迁移至 packages/builtin-tools/)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: 添加 builtin-tools 路径别名至 tsconfig,更新 bun.lock

- tsconfig.json 新增 builtin-tools/* 和 builtin-tools 路径映射
- 新增 packages/builtin-tools/src 至 include

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* refactor: 为 builtin-tools、mcp-client、agent-tools 添加 @claude-code-best 作用域前缀

所有包名及 import 路径统一添加 @claude-code-best/ 前缀:
- builtin-tools → @claude-code-best/builtin-tools
- mcp-client → @claude-code-best/mcp-client
- agent-tools → @claude-code-best/agent-tools

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: 修复 node 环境没有 bun 的问题

---------

Co-authored-by: Eric-Guo <eric.guocz@gmail.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 09:52:05 +08:00

3.2 KiB

@anthropic/ink Documentation

A terminal React rendering framework for building rich command-line interfaces.

Architecture Overview

@anthropic/ink is a forked/internal Ink framework that renders React components directly to the terminal using ANSI escape sequences. It uses Yoga (via a custom layout engine) for Flexbox layout, a custom React reconciler for terminal DOM, and a screen-buffer differ for efficient updates.

Three-Layer Architecture

┌─────────────────────────────────────────┐
│  Layer 3: Theme                         │
│  ThemeProvider, ThemedBox, ThemedText,  │
│  Dialog, FuzzyPicker, ProgressBar, etc. │
├─────────────────────────────────────────┤
│  Layer 2: Components                    │
│  Box, Text, ScrollBox, Button, Link,    │
│  Newline, Spacer, AlternateScreen       │
├─────────────────────────────────────────┤
│  Layer 1: Core                          │
│  Reconciler, Layout (Yoga), Terminal    │
│  I/O, Screen Buffer, Event System       │
└─────────────────────────────────────────┘
  • Core (src/core/) -- Rendering engine: React reconciler, Yoga flexbox layout, terminal I/O, screen buffer with diff-based updates, event system (keyboard, mouse, focus, click).
  • Components (src/components/) -- UI primitives: Box, Text, ScrollBox, Button, Link, Newline, Spacer, etc. Plus context providers (App, StdinContext).
  • Theme (src/theme/) -- Theme system: ThemeProvider, theme-aware Box/Text wrappers, and design-system components (Dialog, FuzzyPicker, ProgressBar, Tabs, etc.).

Documentation

Chapter File Contents
1 Getting Started Installation, rendering, basic concepts
2 Layout System Box, Flexbox, Yoga, positioning, dimensions
3 Text & Styling Text component, colors, text wrapping, ANSI styling
4 Theme System ThemeProvider, themes, ThemedBox, ThemedText, color()
5 Design System Components Dialog, ProgressBar, FuzzyPicker, Tabs, Spinner, etc.
6 Scrolling ScrollBox, sticky scroll, imperative scroll API
7 User Input useInput, Key types, raw mode, mouse events
8 Keybinding System KeybindingProvider, useKeybinding, chord sequences, parser
9 Hooks Reference All hooks with full API signatures
10 Events & Focus Event system, FocusManager, click/hover, tab navigation
11 Core Architecture Reconciler, screen buffer, terminal I/O, rendering pipeline
12 Terminal Integration Alternate screen, mouse tracking, clipboard, notifications