jpmschweitzerandClaude add028eed0
test / unit + widget + golden + a11y (push) Failing after 33s
test / integration_test (xvfb) (push) Has been skipped
test / bundle smoke (xvfb 5s) (push) Has been skipped
test / daemon subprocess + web WASM smoke (push) Has been skipped
test / dart doc (lib API) (push) Failing after 1m2s
stop tracking .pql/hooks — finish T-28 decommission
pql 1.4.x bakes the absolute path to the pql binary into each hook
when init plants them. Tracking the hooks made every developer's
init produce a permanent dirty diff against the committed paths.
The right fix per T-28 is to never track them: each clone's
'pql init' plants its own hooks locally, nothing tracked, no drift.

Drops:
- !.pql/hooks/ from .gitignore (now ignored alongside the rest of
  .pql/)
- !.pql/pql-plan.json from .gitignore (the legacy snapshot was
  deleted in the changelog migration; this un-ignore was already
  dead)
- The four tracked hook files (git rm --cached); local copies stay
  on disk and continue working.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-11 18:49:42 +02:00
2026-05-03 21:51:59 +02:00
2026-04-20 20:30:51 +02:00
2026-04-23 00:37:20 +02:00

clide

An IDE for Claude Code CLI. Native rendering, terminal-first interaction, pql-powered queries, canvas and graph surfaces. Linux and macOS.

Architecture

Single Flutter package at the repo root. The app hosts everything in-process: IPC server, subsystem handlers (pane, files, editor, git, pql), and the extension framework. tmux owns Claude session persistence.

  • lib/ — all Dart code. Kernel services (theme, i18n, settings, panels, commands, focus), UI widgets, built-in extensions, and the extension contract.
  • ptyc/ — small C helper. Spawns a PTY + child and hands the master fd back over SCM_RIGHTS. Every pane (shell, tmux, claude, LSP, debug adapter) goes through it.
  • pql — external supporter tool. Clide wraps it for every query surface; never re-implements it.

Claude drives the UI through a clide CLI surface (Bash, not MCP). Every CLI subcommand has a UI affordance and every UI action has a CLI equivalent.

Built-in extensions

canvas, claude, claude_control, decisions, diff, editor, extensions_ui, files, git, graph, grammars_core, ipc_status, keybindings_ui, markdown, pql, problems, settings_ui, terminal, theme_picker, tickets, todos, welcome.

Building

Requires Flutter (stable channel) on the host. One-time setup:

make hooks && flutter pub get

Then:

make run              # launch the desktop app
make test             # fast suite: analyze + format + unit + widget + golden
make test-core        # core subsystem tests (IPC, PTY, git, pane registry)
make test-integration # real app boot integration tests
make build-linux      # flutter build linux
make build-macos      # flutter build macos
make ptyc-build       # build the ptyc PTY-spawn helper
make push-check       # pre-push gate: decisions + core + fast tests

Status

Pre-v2.0 (2.0.0-dev). Interaction model and panel system landed. The Python Textual v1.2.0 predecessor is archived under legacy/.

Design doc: docs/initial-plan.md. Architectural decisions: decisions/.

License

MIT. See LICENSE.

S
Description
CLI Claude
Readme MIT
32 MiB
Languages
Dart 86.3%
Python 8.2%
Tree-sitter Query 1.7%
Shell 0.8%
C 0.6%
Other 2.2%