copane 发布：在终端里把代码编辑器与 Claude Code 并排放置

Your editor and your AI coding agent, side by side in one terminal.

A fast, keyboard-first code editor with Claude Code (or any AI CLI) living in the next pane: ask for a change, watch it land in your buffer, review the diff, keep it or undo it.

Why copane?

AI agents edit your files from a terminal, but you still need an editor to see, steer and check their work. Usually that means juggling two apps. copane puts both in one window and wires them together:

• 🤖 The real CLI, not a wrapper. The AI pane is a true terminal running Claude Code, so you keep every feature: tools, approvals, slash commands, sessions. Swap in codex, opencode, gemini or your shell.
• ⚡ Context in one key. Select code and press Ctrl+L: the agent gets @file#L10-20 and the snippet.
• 👀 See every change. Files the agent edits reload live, changed lines flash, the gutter marks what differs from git, and Ctrl+Alt+D reviews every change with a diff. Ctrl+Z undoes the agent's edit.
• 🔀 No lost work. Typing while the agent edits the same file? Merge both, compare, or pick a side.
• 🧠 A real editor. Language servers (TypeScript, Rust, Go, Python, Zig, C/C++), autocomplete, go to definition, rename, multi-cursor, Tree-sitter highlighting, project search and replace, Prettier, a live Markdown preview, and images right in the terminal.
• 🌿 Git built in. Stage hunks, commit (with AI-written messages), push, blame, file history, branches and merge-conflict resolution.
• ⌨️ VS Code keys. Ctrl+P, F1, Ctrl+D, F12, F2… and Import VS Code settings in one step.
• 🚀 Fast and light. One self-contained binary, instant start in big repos, ~30 ms per keystroke in an 11,000-line file.

Install

Linux, macOS, or Windows through WSL:

curl -fsSL https://raw.githubusercontent.com/sevheng/copane/main/install.sh | sh

This installs copane and a short ce alias in ~/.local/bin, plus the bundled Nerd Font for file-tree icons. No Bun or Node needed. VERSION=v0.1.0 pins a release, PREFIX=/usr/local installs elsewhere, ALIAS=cx (or ALIAS=) changes the alias, and FONT=0 skips the font. You can also download a binary from Releases.

You'll want Claude Code (claude) on your PATH, or set another CLI in the config.

Then open things the way VS Code's code does:

ce .                 # this folder
ce src/main.ts       # a file (its project folder is the workspace)
ce ~/projects/app    # another folder

Updating: ce --upgrade installs the latest release in place (or run the install line again). After an update, every open editor shows "⟳ Update installed: restart" in the status bar. Click it or press Ctrl+Alt+R: unsaved files prompt first, then the editor restarts on the new version with the same folder and tabs.

ce --version prints the installed version.

Uninstall: rm -r ~/.local/bin/copane ~/.local/bin/ce ~/.local/lib/copane.

From source

Needs Bun 1.4.3 or later (curl -fsSL https://bun.sh/install | bash).

git clone https://github.com/sevheng/copane.git
cd copane
bun install
bun run dev                 # open the current directory (or pass a file or folder)
bun run install:cli         # build and install ~/.local/bin/copane + `ce`, plus the bundled Nerd Font

install:cli takes the same PREFIX and ALIAS variables. Ctrl+Alt+R restarts bun run dev, which picks up source changes.

Built with Bun and OpenTUI. Linux and macOS only, because it uses Bun's POSIX pseudo-terminal.

Working with the AI

The editor is built around a loop: ask Claude, see what it changed, keep or undo it.

1. Give context. Select lines, or nothing for the whole file, and press Ctrl+L. The AI prompt gets @path#L10-20 plus the snippet. In the tree, right-click a file or folder and choose Send to AI.
2. Ask. Ctrl+J moves you to the AI pane and back. Unsaved files are saved when you switch, so Claude reads what you see. Turn this off with editor.saveBeforeAi: false.
3. See what changed. Files Claude edits reload automatically, and the changed lines flash. The line numbers mark lines that differ from the last commit: ▎ green added, yellow changed, and a red ▁ for deleted. The tree marks changed files.
4. Review everything. Ctrl+Alt+D lists all changed files with a diff. Enter opens a file at the change, and r reverts it.
   • Turn by turn (Ctrl+Alt+Z): each prompt you send becomes a turn that lists the files the AI changed, with +/− counts and each change since before the turn. u undoes the whole turn (asking first if you've edited those files since), x one file, r one change. Files the AI created are removed. It works with any CLI, because it watches files, not the CLI.
5. Undo. Ctrl+Z also undoes a reload, so you can step back through Claude's edit in the editor.
6. Edits on both sides. When Claude changes a file you have unsaved edits in, a bar offers:
   • Merge both: keeps your edits and Claude's. Only offered when they don't touch the same lines.
   • Compare: shows the two versions side by side as a diff.
   • Use disk: takes Claude's version.
   • Keep mine: keeps yours, and your next save overwrites Claude's.

One-click requests: right-click in the editor, or use F1, for AI: explain this, AI: find and fix bugs, or AI: write tests. Each sends the selection, or the whole file, together with the request, and submits it.

Hand over problems and changes. These type a ready prompt into the AI pane and leave submitting to you:

• Ctrl+K F, fix problems: the language server's errors and warnings, as @file#L12 error: …, for the current file (or every open file when it has none). Also f in the Problems list (Ctrl+Alt+E), and Ask AI to fix in the quick-fix menu (Alt+.) for the line you're on.
• Ctrl+K D, review changes: your git diff (the staged changes if any, otherwise everything uncommitted, plus new files) with "review these for bugs". Also v in Source control. A diff too big to paste is sent as the list of changed files.

Run commands from the AI pane with !, for example ! bun test.

Several agents. Ctrl+Alt+N (or + agent in the AI pane's header) starts another CLI in a new tab, such as a second Claude for another task, or Codex beside Claude. Each tab keeps running while hidden, and its header shows whether it's working, done or waiting for you. Ctrl+Alt+PageDown / PageUp switch tabs, and Ctrl+L and the other "send to AI" keys go to the visible one. Pick …in a git worktree to give an agent its own checkout (../<project>-<agent>-1 on branch copane/<agent>-1), so parallel agents never edit the same files; closing that tab offers to remove the worktree while keeping its branch. List extra CLIs in the config: "ai": { "agents": [{ "name": "codex", "command": "codex" }] }.

Look away while it works. When the AI finishes, or stops to ask you something (an approval prompt), while you're in the editor or another window, copane tells you:

• a notice ("claude finished" / "claude is waiting for your answer")
• the terminal bell (Windows Terminal flashes the taskbar)
• ✓ done / ⚠ needs you in the AI pane header and the status bar, until you look (Ctrl+J)

With "ai": { "notify": "desktop" } you also get a system notification: a Windows toast on WSL, Notification Center on macOS, notify-send on Linux. "off" turns it all off.

Big projects

• Ctrl+P: an empty query lists recently opened files first. The file index is built in the background at startup, so the first Ctrl+P is instant.
  • @name: jumps to a symbol in this file, using the language server or, without one, a pattern scan that also finds describe/it test blocks.
  • #name: searches symbols across the project, through the language server.
  • :120: goes to a line.
• Ctrl+Alt+← / →: back and forward through your jumps (definition, references, search results, go to line, picker).
• Long files: stay responsive. Syntax colours and indent guides are computed for the whole file, but only lines near the screen are drawn. An 11,000-line file takes about 30 ms per keystroke.
• CE_PERF=/tmp/ce-perf.log ce: logs how long each keypress takes to reach the screen.

Look

• Panes: the panes have no boxes. A thin divider separates them: drag it to resize, double-click it to go back to the default width.
• Headers: each pane has one. The left pane has two tabs, FILES (the tree) and SEARCH (search and replace in all files); click one to switch. The editor's header is its tab row, with icons, and the active tab is accent-coloured while the editor has focus. The AI pane shows the command and ● ready, or a spinner while it's working.
• Breadcrumbs: under the tabs, src › editor › EditorPane.tsx › BufferView shows the folder path, the file and the symbol under the cursor. Click a folder to show it in the tree.
• Status bar, left to right:
  • Git branch, with ↑ahead / ↓behind counts. Click it to review changes.
  • Problems.
  • A message or hints.
  • Position and selection size. Click it to go to a line.
  • Language, line endings and language servers.
  • The AI. Click it to switch focus.
• In the editor:
  • The cursor's line has a slightly lighter background.
  • The bracket matching the one at the cursor is highlighted.
  • Other uses of the word under the cursor get a subtle highlight.
  • Indent levels show as faint guides.
  • Turn these off with editor.highlightCursor and editor.indentGuides.

Git

• Source control (Ctrl+Alt+D, or click the branch in the status bar**):** merge conflicts, staged files and changed files, with the diff of the selected one.
  • Staging: Space stages or unstages, a stages everything, and r reverts (after a confirmation).
  • Committing: write a message and press Enter (or Alt+Enter from anywhere in the panel) to commit. With nothing staged, it offers to stage everything. Amend rewrites the last commit.
  • AI message (m): asks claude -p to write a message from the staged diff. You review it before committing. Turn it off with git.aiCommitMessage: false.
  • Push and pull (P / U): show progress. A branch without an upstream gets offered "publish". With no remote, it says so.
• Changes in the editor:
  • Markers: the ▎ markers compare with what's staged, so staged lines lose theirs.
  • Peek: Alt+H, or a click on a marker, shows the change inline. s stages just that change, and r reverts it (Ctrl+Z undoes).
  • Navigation: Alt+F5 / Shift+Alt+F5 jump to the next / previous change, as in VS Code.
• Blame: the status bar shows who last changed the cursor's line, for example Ann · 3 days ago · Fix totals. Lines you haven't committed show Not committed yet. Click it for the commit. Turn it off with git.blame: false.
• Ctrl+Alt+G, file history: the file's commits, with each commit's changes. y copies a commit id.
• Ctrl+Alt+B, branches: switch with fuzzy search, or type a new name to create a branch. It offers to save unsaved files first, and shows git's own error if the switch fails.
• Merge conflicts: your side is tinted green and the incoming side blue. A bar shows the count and Accept current / incoming / both (Alt+1 / Alt+2 / Alt+3 while the cursor is in a conflict), and Alt+F5 goes to the next conflict. When you're done, save and stage the file.

Markdown and images

• Markdown preview:
  • Ctrl+K V: a live preview beside the file that follows your typing and the AI's edits.
  • Alt+Shift+V: the preview as its own tab; on the preview tab, it goes back to the file.
  • Both are in the editor's right-click menu, and "Open Preview" is in the tree's.
  • It renders GitHub-flavoured Markdown the way GitHub shows a README:
    • headings with rules, bold, italic, strikethrough and inline code, and links
    • nested lists and task checkboxes, quotes, and > [!NOTE] alerts
    • highlighted code blocks, tables with column alignment, footnotes
    • the HTML READMEs use: centred <div align="center"> blocks, <b>, <br>, <img>, <details>, and <table>s
    • GitHub's emoji shortcodes (:rocket: → 🚀)
  • Arrow keys, PgUp/PgDn and Home/End scroll a preview tab, and the mouse wheel scrolls both.
  • Images in the file show in the preview when they are local. Remote images (badges, for example) aren't downloaded, so they show their alt text.
• Images: PNG, JPEG, WebP and GIF open as a tab instead of an error, with the format, size and file size above the picture. Animated GIFs play (Space pauses), in image tabs and in the Markdown preview, and stop while hidden. Small images keep their own size, and big ones shrink to fit. They reload when the file changes. Ctrl+L sends the image to the AI as @path, and Claude Code can look at it. SVG files open as text.
• How images are drawn: sharp pictures in terminals with kitty graphics or sixel (kitty, WezTerm, Ghostty, foot, iTerm2, and Windows Terminal 1.22+), and coloured blocks elsewhere and inside tmux. If the picture is blank or garbled, set "preview": { "imageProtocol": "blocks" } (or "sixel", "kitty").

Code intelligence

The editor talks to language servers for errors, autocomplete, type info and go-to-definition.

Servers:

• TypeScript and JavaScript: the project's own TypeScript 7 (tsc --lsp) when it's installed, otherwise typescript-language-server.
• Others: rust-analyzer, gopls, pyright-langserver (or pylsp), zls and clangd, whenever they're on your PATH.
• When they run: a server starts the first time you open a file of its language, and stops when you quit.

Features:

• Errors and warnings: a ● before the line number, red for errors and yellow for warnings. The text is underlined.
  • Status bar: shows ✖ 2 ⚠ 1; click it for the Problems list.
  • Cursor line: with the cursor on a line that has a problem, the status bar shows the message.
• F8: next problem. Ctrl+Alt+E: all problems in open files.
• Autocomplete:
  • When it appears: suggestions show after ., or once you've typed two letters. Ctrl+Space asks for them anytime.
  • Picking one: ↑↓ to choose, Enter or Tab to accept, Esc to close.
  • Turning it off: set editor.autocomplete: false.
• Ctrl+Alt+I: type info and docs for the symbol under the cursor, plus any problem on that line.
• F12 or Ctrl+click: go to definition, across files (Alt+click also works, for terminals that keep Ctrl+click). Ctrl+Alt+← comes back. Shift+F12: all references.
• F2: rename the symbol under the cursor in every file. Open files change in place, and Ctrl+Z undoes it. Closed files are saved directly.
• Shift+Alt+F (or Ctrl+Alt+L): format the file. Projects with Prettier (in node_modules, or a Prettier config and prettier on PATH) use Prettier, as VS Code's Prettier extension does. Other files use the language server. editor.formatter forces one ("prettier" or "lsp"), and editor.formatOnSave: true formats on Ctrl+S.
• Parameter hints: while you type arguments in a call, its signature shows above the cursor, with the current parameter highlighted. Turn this off with editor.parameterHints: false.

Use another server, or turn one off, in the config: { "lsp": { "python": { "command": ["pylsp"] }, "go": false } }.

Coming from VS Code

Most VS Code keys work as you expect: Ctrl+P, Ctrl+Shift+P (or F1), Ctrl+S, Ctrl+F, Ctrl+G, Ctrl+D, Ctrl+/, F2, F12, Shift+F12, Shift+Alt+F, Alt+↑/↓ to move lines, Shift+Alt+↑/↓ to copy them, Alt+←/→ back and forward, Alt+1–9 for tabs, Home/End, and the common Ctrl+K chords (Ctrl+K Ctrl+C, Ctrl+K Ctrl+U, Ctrl+K Ctrl+S, Ctrl+K Z, Ctrl+K S).

Terminals can't send some Ctrl+Shift keys (they arrive as the plain Ctrl key), so those have stand-ins:

Settings that match VS Code's: editor.wordWrap (Alt+Z toggles it), editor.formatOnSave, editor.autoClosingBrackets. Import VS Code settings in the palette (F1) copies yours into the config (it finds VS Code's settings on Linux, macOS, Windows, and Windows from WSL). Ctrl+F starts with the selection or the word under the cursor, and typing replaces it.

Rebind anything in ~/.config/copane/config.json under keys (command names are in src/keymap/commands.ts), including two-key chords: { "keys": { "editor": { "ctrl+k ctrl+w": "buffer.close" } } }.

Keys

Press F1 for the command palette: every command, searchable, with its shortcut. Press Ctrl+Alt+K for a grouped cheat sheet.

Typing: Enter keeps the line's indent, one level more after {, ( or [, and between a pair like {} the closer goes to its own line. Brackets and quotes close themselves, typing the closer steps over it, and Backspace between an empty pair deletes both. A bracket or quote typed over a selection wraps it. Turn these off with editor.autoIndent: false and editor.autoClosingBrackets: false.

Multi-cursor (Ctrl+D):

• Selecting: the first press selects the word under the cursor, and each press adds the next occurrence. Ctrl+Alt+A takes all of them.
• Editing: typing, Backspace and Ctrl+V change every occurrence at once. The status bar shows how many are active.
• Leaving: Esc, an arrow key or a click ends it.
• Matching: starting from a word matches whole words only. Starting from a selection matches the exact text.

Find bar:

• Enter or ↓ goes to the next match, ↑ to the previous, and Esc closes the bar.
• Search ignores case unless your text has a capital letter.
• In the replace field, Enter replaces one match and Alt+Enter replaces all. Each replace is a single undo step.

While the AI pane has focus, every key goes to the CLI except Ctrl+Q, Ctrl+B, Ctrl+E, Ctrl+J, Ctrl+P, F1, Ctrl+Alt+J, Ctrl+Alt+D and Ctrl+Alt+R. Esc, Ctrl+C and Shift+Tab therefore work in Claude Code as usual.

Dragged pane widths are remembered in ~/.local/state/copane/layout.json.

File tree

With the tree focused (Ctrl+B), or from the right-click menu on a row:

The menu also has the reveal item, Copy Path, Copy Relative Path, Send to AI (types @path into the AI prompt), and Open Preview for Markdown files. Right-click empty space to create at the project root, or to reveal the project folder. In the editor, Shift+Alt+R reveals the open file. Open tabs follow renames; deleting closes their tabs unless they have unsaved changes.

In a git repository the tree shows status: M modified (yellow), U untracked, A added, R renamed (green), ! conflict (red). A folder shows • in the colour of the most important change inside it. Marks update when files change and when you stage or commit.

Icons

The tree shows file-type icons. Set the style in the config: { "tree": { "icons": "nerd" } }.

Both install scripts set this up by running copane --install-font, which you can also run yourself. It installs the bundled CaskaydiaMono Nerd Font, which is Cascadia Mono plus icons, from assets/fonts/. It works offline. It is the non-Mono variant, so icons are drawn full size instead of squeezed into one letter's width.

• WSL with Windows Terminal:
  • Font: installed for your Windows user, with no admin needed.
  • Windows Terminal: the font becomes its default. This only happens when no font is chosen there yet, or when an earlier install set "CaskaydiaMono Nerd Font Mono", which is switched to the new face. settings.json is backed up next to itself first.
  • Editor: tree.icons is set to "nerd", unless you already set it.
  • Close every Windows Terminal window and open it again, once, to load the font. A new tab or a ce restart is not enough, because Windows Terminal reads fonts only when it starts.
• macOS and Linux: the font is copied to ~/Library/Fonts or ~/.local/share/fonts. Choose "CaskaydiaMono Nerd Font" in your terminal, then set tree.icons to "nerd".
• Skip it: set FONT=0 when installing. Once the font is set up, later installs skip this step; FONT=force copane --install-font redoes it.
• Undo: set tree.icons to "simple", or restore the settings.json.bak-… file in Windows Terminal's settings folder.

If icons show as boxes, your terminal isn't using a Nerd Font yet. On Windows, fully close and reopen Windows Terminal.

Mouse

• Editor: click to place the cursor, drag to select, double-click selects a word. The wheel scrolls without moving the cursor, and Shift+wheel scrolls sideways.
• Line numbers: click a number to select that line, drag to select several.
• Ctrl+click (or Alt+click) a name to go to its definition.
• Right-click: a menu with Go to definition, Find all references, Cut, Copy, Paste, Select all and Send to AI. In the AI pane it offers Copy, Paste and Restart.
• Panes: clicking a pane focuses it. Drag the border between panes to resize them, and double-click it to reset that pane's width.
• Tree and picker: the wheel scrolls, rows highlight on hover, and a click opens the file or toggles the folder. Right-click a tree row for file actions.
• Tabs: click to switch, click × or middle-click to close, wheel over the tab bar to cycle.
• Status bar: the key hints are buttons, and clicking the AI status switches focus.
• Dialogs: buttons are clickable, and clicking outside closes them.
• AI pane: select text with the mouse to copy it. Ctrl+C stays with the CLI.

While the editor captures the mouse, most terminals use Shift+drag for their own text selection.

Copying goes to the system clipboard through the terminal (OSC 52) and through powershell.exe on WSL, pbcopy on macOS, or wl-copy, xclip or xsel on Linux. Pasting with Ctrl+V reads the clipboard through the same tools. Your terminal's own paste shortcut also works. Inside tmux, enable set -g mouse on and set -g set-clipboard on.

Config

Optional file at ~/.config/copane/config.json. Open settings (JSON) in the palette (F1) opens it and creates it if needed. Comments and trailing commas are allowed, as in VS Code.

{
  "ai": { "command": "claude", "args": [], "startHidden": false, "notify": "bell", "agents": [{ "name": "codex", "command": "codex" }] },
  "editor": { "highlightMaxBytes": 1000000, "copyOnSelect": false, "saveBeforeAi": true, "autocomplete": true, "wordWrap": false, "highlightCursor": true, "indentGuides": true, "autoIndent": true, "autoClosingBrackets": true, "formatter": "auto", "formatOnSave": false },
  "lsp": { "python": { "command": ["pylsp"] } },
  "tree": { "icons": "simple" },
  "preview": { "imageProtocol": "auto" },
  "keys": { "global": { "ctrl+o": "file.picker", "ctrl+l": null } }
}

ai.command can be any terminal program, for example codex, opencode, gemini or your shell. Key overrides map a key to a command name from src/keymap/commands.ts, and null removes a binding. The command palette (F1) shows every command.

Syntax highlighting

Highlighting uses Tree-sitter through OpenTUI, for JavaScript, TypeScript, TSX, Python, Rust, Go, C, C++, Bash, HTML, CSS, JSON (and JSONC), YAML, TOML, Markdown and Zig. The same grammars colour fenced code blocks in the Markdown preview. The grammars are embedded in the binary, so nothing needs installing. To add a language, see src/editor/grammars.ts.

Development

bun test           # unit and render tests
bun run typecheck

scripts/smoke.md is the manual checklist for things the tests cannot cover.

Contributing

If copane saves you a context switch, a ⭐ on GitHub helps other people find it.

Issues and pull requests are welcome, including ones written with an AI coding agent. Look for good first issue and agent-friendly issues; each says where to start and what "done" means. CONTRIBUTING.md covers setup and tests, AGENTS.md the architecture and rules (your agent reads it automatically), and CHANGELOG.md what's new.

License

MIT. The bundled CaskaydiaMono Nerd Font is under the SIL Open Font License 1.1 (assets/fonts/LICENSE-OFL.txt).