Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
9195e9f
feat: add OpenTUI terminal UI and shared TUI core
CjLogic Nov 16, 2026
f52780f
feat: OpenTUI slash commands, pickers, multi-line composer, and alerts
CjLogic Nov 17, 2026
ef6c963
feat(opentui): extension UI questions and full not-yet-ported list
CjLogic Nov 17, 2026
58ed288
feat(opentui): termcn thinking-block panel for reasoning
CjLogic Nov 17, 2026
64ff74a
feat(opentui): markdown replies and reasoning in native scrollback
CjLogic Nov 17, 2026
f1e2c07
feat(opentui): sectioned turn layout for reasoning and agent work
CjLogic Nov 18, 2026
6010754
feat(agent): per-tool file_diff events from workspace snapshots
CjLogic Nov 19, 2026
7de71ee
feat(tui-core): attach file_diff results to tool blocks
CjLogic Nov 19, 2026
f3d4b87
feat(opentui): full-screen transcript, inline diffs, adaptive icons
CjLogic Nov 19, 2026
ced9ff0
feat(tui-core): repository name for the status line
CjLogic Nov 19, 2026
66c602c
feat(opentui): status line, prompt history, terminal commands
CjLogic Nov 19, 2026
f855f25
feat(tui-core): shared clipboard and image-path helpers, attach dedupe
CjLogic Nov 19, 2026
fc380e4
feat(opentui): syntax highlighting, @ path suggestions, composer shor…
CjLogic Nov 19, 2026
b7fb604
feat(tui-core): shared crew task reader and async git label
CjLogic Nov 19, 2026
f4683aa
feat(opentui): right sidebar, branching from /sessions
CjLogic Nov 19, 2026
d6fc29e
feat(tui-core): shared theme loader with syntax and markdown colors
CjLogic Nov 20, 2026
da89ee8
feat(opentui): themes, /theme picker with live preview, markdown colors
CjLogic Nov 20, 2026
0aa9b41
fix(agent): time reply throughput without tool and approval waits
CjLogic Nov 20, 2026
7fbe919
refactor(tui-core): share formatTokensPerSecond
CjLogic Nov 20, 2026
ec2c68e
feat(opentui): inline image pixels and reply throughput; skip Live UI
CjLogic Nov 20, 2026
b1d0b63
feat(opentui): live crews, tmux, status panels, logo pulse, transcrip…
CjLogic Nov 21, 2026
27bf889
feat(opentui): audit ports (plans, extension renderers, /goal form), …
CjLogic Nov 21, 2026
ea41279
test(opentui): isolate tests from the operator's CREWCODER_* environment
CjLogic Nov 21, 2026
45e475f
fix(agent): name the cause when the Codex app-server crashes on start
CjLogic Nov 21, 2026
5c9d1bd
Merge remote-tracking branch 'origin/main' into crewcoder-opentui
CjLogic Nov 21, 2026
40a2b32
fix: green CI after merging main (SDK file tools, Codex fixture, imag…
CjLogic Nov 21, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions .github/workflows/sdk-check.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ on:
- "crewcoder-agent/**"
- "crewcoder-client/**"
- "crewcoder-tui/**"
- "crewcoder-tui-core/**"
- "crewcoder-opentui/**"
- "crewcoder-sdk/**"
- "bin/**"
- "lib/**"
Expand All @@ -23,6 +25,8 @@ on:
- "crewcoder-agent/**"
- "crewcoder-client/**"
- "crewcoder-tui/**"
- "crewcoder-tui-core/**"
- "crewcoder-opentui/**"
- "crewcoder-sdk/**"
- "bin/**"
- "lib/**"
Expand Down Expand Up @@ -50,3 +54,18 @@ jobs:
cache: npm
- run: npm ci --ignore-scripts
- run: npm run release:check:sdk

opentui:
# OpenTUI's native layer needs Node.js >=26.4, so its renderer tests run on a
# separate runtime from the Node 22 packages.
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 26
cache: npm
- run: npm ci --ignore-scripts
- run: npm run test -w @onpoint-dev-tools/crewcoder-tui-core
- run: npm run typecheck -w @onpoint-dev-tools/crewcoder-opentui
- run: npm run test -w @onpoint-dev-tools/crewcoder-opentui
26 changes: 24 additions & 2 deletions .github/workflows/sdk-release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,9 @@ jobs:
run: npm install --global npm@11.8.0
- run: npm ci --ignore-scripts
- run: npm run build -w @onpoint-dev-tools/crewcoder-agent
- run: npm run build -w @onpoint-dev-tools/crewcoder-tui-core
- run: npm run build -w @onpoint-dev-tools/crewcoder-tui
- run: npm run build -w @onpoint-dev-tools/crewcoder-opentui
- run: npm run build -w @onpoint-dev-tools/crewcoder-client
- run: npm run build -w @onpoint-dev-tools/crewcoder-sdk
- name: Verify explicit publish gates
Expand All @@ -59,16 +61,36 @@ jobs:
fi
- name: Verify published agent runtime
run: node scripts/wait-for-npm-package.cjs @onpoint-dev-tools/crewcoder-agent crewcoder-agent/package.json
- name: Publish terminal UI
- name: Publish TUI core
run: |
PACKAGE_VERSION="$(node -p "require('./crewcoder-tui-core/package.json').version")"
if npm view "@onpoint-dev-tools/crewcoder-tui-core@${PACKAGE_VERSION}" version >/dev/null 2>&1; then
echo "TUI core ${PACKAGE_VERSION} is already published; continuing the partial release."
else
npm publish -w @onpoint-dev-tools/crewcoder-tui-core --access public --provenance
fi
- name: Verify published TUI core
run: node scripts/wait-for-npm-package.cjs @onpoint-dev-tools/crewcoder-tui-core crewcoder-tui-core/package.json
- name: Publish legacy terminal UI
run: |
PACKAGE_VERSION="$(node -p "require('./crewcoder-tui/package.json').version")"
if npm view "@onpoint-dev-tools/crewcoder-tui@${PACKAGE_VERSION}" version >/dev/null 2>&1; then
echo "TUI ${PACKAGE_VERSION} is already published; continuing the partial release."
else
npm publish -w @onpoint-dev-tools/crewcoder-tui --access public --provenance
fi
- name: Verify published terminal UI
- name: Verify published legacy terminal UI
run: node scripts/wait-for-npm-package.cjs @onpoint-dev-tools/crewcoder-tui crewcoder-tui/package.json
- name: Publish OpenTUI terminal UI
run: |
PACKAGE_VERSION="$(node -p "require('./crewcoder-opentui/package.json').version")"
if npm view "@onpoint-dev-tools/crewcoder-opentui@${PACKAGE_VERSION}" version >/dev/null 2>&1; then
echo "OpenTUI terminal UI ${PACKAGE_VERSION} is already published; continuing the partial release."
else
npm publish -w @onpoint-dev-tools/crewcoder-opentui --access public --provenance
fi
- name: Verify published OpenTUI terminal UI
run: node scripts/wait-for-npm-package.cjs @onpoint-dev-tools/crewcoder-opentui crewcoder-opentui/package.json
- name: Publish browser client
run: |
PACKAGE_VERSION="$(node -p "require('./crewcoder-client/package.json').version")"
Expand Down
27 changes: 15 additions & 12 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,20 +47,30 @@ Update corresponding Docs `crewcoder-agent/docs/*`, `crewcoder-tui/docs/*`, and

## CLI umbrella package

The public root `crewcoder` package is the one-command installer and launcher for both scoped runtime packages. Its `crewcoder` and `crew` bins must open `@onpoint-dev-tools/crewcoder-tui` with no arguments and forward argument-bearing invocations to `@onpoint-dev-tools/crewcoder-agent`. Never restore the `cc` alias because it shadows the standard Unix C compiler command. Keep both runtime dependencies in the root package and publish the umbrella only after those exact versions exist on npm.
The public root `crewcoder` package is the one-command installer and launcher. Its `crewcoder` and `crew` bins open `@onpoint-dev-tools/crewcoder-opentui` with no arguments and forward argument-bearing invocations to `@onpoint-dev-tools/crewcoder-agent`. Never restore the `cc` alias because it shadows the standard Unix C compiler command. The agent is a required dependency; `crewcoder-opentui` is an **optionalDependency** because it needs Node.js >=26.4 and OpenTUI native binaries, and headless VPS/sandbox installs must succeed without it. Do not make it required. For a bare call, `lib/launcher.js` refuses with guidance (legacy UI and agent commands) when there is no interactive terminal, the TUI is not installed, or Node.js is below the TUI's `engines.node` floor; it adds `--disable-warning=ExperimentalWarning` only for the TUI child. Publish the umbrella only after the exact pinned versions exist on npm.

The scoped agent package still provides `crewcoder`, `crew`, and `crewcoder-agent`; the scoped TUI package provides `crewcoder-tui` for independent development and packaging.
`@onpoint-dev-tools/crewcoder-tui` is the legacy custom-renderer UI. It is published separately for users who prefer it and must not be an umbrella dependency. Both UIs share `@onpoint-dev-tools/crewcoder-tui-core` (bridge, event parser, reducer, state); keep UI-independent code there instead of duplicating it. See `crewcoder-opentui/README.md` for the OpenTUI preview's ported and missing features.

The scoped agent package still provides `crewcoder`, `crew`, and `crewcoder-agent`; its own bare invocation launches the legacy `crewcoder-tui` from `PATH`. The scoped TUI packages provide `crewcoder-tui` and `crewcoder-opentui` for independent installs.

## MonoRepo DIR

CODING AGENT

- /home/aura/my-cmd/CrewCoder-Mono/crewcoder/crewcoder-agent

TUI
TUI (OpenTUI, launched by the umbrella; Node.js >=26.4)

- /home/aura/my-cmd/CrewCoder-Mono/crewcoder/crewcoder-opentui

Legacy TUI

- /home/aura/my-cmd/CrewCoder-Mono/crewcoder/crewcoder-tui

Shared TUI runtime (bridge, reducer, state)

- /home/aura/my-cmd/CrewCoder-Mono/crewcoder/crewcoder-tui-core

SDK

- /home/aura/my-cmd/CrewCoder-Mono/crewcoder/crewcoder-sdk
Expand Down Expand Up @@ -201,9 +211,7 @@ crewcoder/
├── tsconfig.json
└── src/
├── cli.ts
├── bridge/
│ ├── crewcoder-process.ts
│ └── event-parser.ts
├── bridge/ # live-ui-*.ts; agent bridge lives in crewcoder-tui-core
├── components/
│ ├── App.ts
│ ├── CommandPalette.ts
Expand All @@ -219,11 +227,6 @@ crewcoder/
│ ├── markdown-renderer.ts
│ ├── modal-view.ts
│ └── path-suggestions.ts
├── state/
│ ├── effort-levels.ts
│ ├── event-reducer.ts
│ ├── tui-store.ts
│ └── usage.ts
├── tests/
│ ├── app-home.test.ts
│ ├── app-input.test.ts
Expand Down Expand Up @@ -268,7 +271,7 @@ crewcoder/
- Durable `/goal` behavior belongs to CrewCoder's detached supervisor (`goal-store.ts` / `goal-runner.ts`), not provider adapters. When `goals.checkModel` is configured, its same-provider tool-free verifier verdict is authoritative; verifier failures must pause rather than fall back to maker self-grading. Goals wait durably for explicit approvals.
- Crew task sidebar labels are session-local presentation numbers that restart at `1` and remain stable across status sorting. Crew task tools and persisted dependency edges must continue using project-wide durable task IDs.
- CI transports (`action.yml`, the GitLab template, and `scripts/run-ci.sh`) must preserve `run --ci` stdout JSON and exit codes. `crewcoder hook install` may only update its managed marker block, must back up unrelated hooks before an explicit force replacement, and must refuse shared/global hook paths outside the repository.
- Coordinated releases use `npm run release -- <major.minor.patch>` to bump the umbrella, agent, browser client, and SDK together while preserving the independent TUI version. Keep `scripts/release.cjs` synchronized with those manifests, exact internal dependency pins, runtime version constants, generated version API baselines, the root lockfile, and the protected npm publishing workflow. Automatic API baseline refreshes may only change the client and SDK `api/version.d.ts` files.
- Coordinated releases use `npm run release -- <major.minor.patch>` to bump the umbrella, agent, browser client, and SDK together while preserving the independent `crewcoder-tui`, `crewcoder-tui-core`, and `crewcoder-opentui` versions (publish order: agent, tui-core, both TUIs, client, SDK, umbrella). Keep `scripts/release.cjs` synchronized with those manifests, exact internal dependency pins, runtime version constants, generated version API baselines, the root lockfile, and the protected npm publishing workflow. Automatic API baseline refreshes may only change the client and SDK `api/version.d.ts` files.
- Validate provider stream changes with package-local checks using isolated env:
`CREWCODER_HOME=/tmp/.crewcoder npm run typecheck -w @onpoint-dev-tools/crewcoder-agent`
`env -u OPENCODE_API_KEY CREWCODER_HOME=/tmp/.crewcoder npm test -w @onpoint-dev-tools/crewcoder-agent`
22 changes: 14 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,15 +26,15 @@ This directory is an npm-workspaces monorepo for the CrewCoder Packages. The roo

## Install CrewCoder

Requires Node.js 22 or newer. The `crewcoder` umbrella package includes both the CrewCoder agent and terminal UI.
Requires Node.js 22 or newer for the agent. The terminal UI that bare `crewcoder` opens ([`crewcoder-opentui`](crewcoder-opentui/README.md), a preview built on OpenTUI) needs Node.js 26.4 or newer and is an optional part of the install: on older Node.js, unsupported platforms, or headless machines, `crewcoder` still installs and every agent command works. The original UI stays available as the [legacy `crewcoder-tui`](crewcoder-tui/README.md) package on Node.js 22+.

### Try it with npx

```sh
npx crewcoder
```

`npx` downloads CrewCoder into npm's cache and launches the TUI without creating a persistent global installation.
`npx` downloads CrewCoder into npm's cache and launches the TUI without creating a persistent global installation. Without Node.js 26.4+ or an interactive terminal, it prints how to continue instead.

### Install globally

Expand Down Expand Up @@ -73,24 +73,29 @@ The scoped packages remain available separately for development and custom packa

```sh
npm install --global @onpoint-dev-tools/crewcoder-agent
npm install --global @onpoint-dev-tools/crewcoder-tui
npm install --global @onpoint-dev-tools/crewcoder-tui # legacy UI, Node.js 22+
npm install --global @onpoint-dev-tools/crewcoder-opentui # OpenTUI UI, Node.js 26.4+
```

Installing only `@onpoint-dev-tools/crewcoder-agent` does not install the TUI. Most CLI users should install the `crewcoder` umbrella package. See the [installation guide](docs/INSTALLATION.md) for install and update details.
Installing only `@onpoint-dev-tools/crewcoder-agent` does not install a TUI; its own bare `crewcoder` opens `crewcoder-tui` when that is on `PATH`. Most CLI users should install the `crewcoder` umbrella package. See the [installation guide](docs/INSTALLATION.md) for install and update details.

## Packages

| Package | npm name | Runs on | What it is | Install command |
|---|---|---|---|---|
| CrewCoder umbrella | `crewcoder` | Node.js 22+ terminal | Recommended CLI package containing both the agent and TUI. |
| CrewCoder umbrella | `crewcoder` | Node.js 22+ (TUI: 26.4+) | Recommended CLI package: the agent plus the optional OpenTUI terminal UI. | `npm install --global crewcoder` |
| [`crewcoder-agent`](https://github.com/OnPoint-Dev-Tools/crewcoder/tree/main/crewcoder-agent) | [`@onpoint-dev-tools/crewcoder-agent`](https://www.npmjs.com/package/@onpoint-dev-tools/crewcoder-agent) | Node.js 22+ / standalone binary | The agent harness: evented agent loop, providers, local tools, durable sessions, goals, crews, extensions, ACP and fleet servers, and the `crewcoder` / `crew` CLI. | `npm install --global @onpoint-dev-tools/crewcoder-agent` |
| [`crewcoder-tui`](https://github.com/OnPoint-Dev-Tools/crewcoder/tree/main/crewcoder-tui) | [`@onpoint-dev-tools/crewcoder-tui`](https://www.npmjs.com/package/@onpoint-dev-tools/crewcoder-tui) | Node.js 22+ terminal | Custom terminal UI (no Ink/React/blessed/curses) driven by the agent's JSON event stream, locally or over SSH. | `npm install --global @onpoint-dev-tools/crewcoder-tui` |
| [`crewcoder-opentui`](https://github.com/OnPoint-Dev-Tools/crewcoder/tree/main/crewcoder-opentui) | [`@onpoint-dev-tools/crewcoder-opentui`](https://www.npmjs.com/package/@onpoint-dev-tools/crewcoder-opentui) | Node.js 26.4+ terminal | Preview terminal UI built on OpenTUI and React; opened by bare `crewcoder`. Not yet at parity with the legacy UI. | `npm install --global @onpoint-dev-tools/crewcoder-opentui` |
| [`crewcoder-tui`](https://github.com/OnPoint-Dev-Tools/crewcoder/tree/main/crewcoder-tui) | [`@onpoint-dev-tools/crewcoder-tui`](https://www.npmjs.com/package/@onpoint-dev-tools/crewcoder-tui) | Node.js 22+ terminal | Legacy custom terminal UI (no Ink/React/blessed/curses) driven by the agent's JSON event stream, locally or over SSH. | `npm install --global @onpoint-dev-tools/crewcoder-tui` |
| [`crewcoder-tui-core`](https://github.com/OnPoint-Dev-Tools/crewcoder/tree/main/crewcoder-tui-core) | [`@onpoint-dev-tools/crewcoder-tui-core`](https://www.npmjs.com/package/@onpoint-dev-tools/crewcoder-tui-core) | Node.js 22+ | Shared, UI-independent TUI runtime: agent process bridge, event parser, reducer, and state. | Installed by both TUIs |
| [`crewcoder-sdk`](https://github.com/OnPoint-Dev-Tools/crewcoder/tree/main/crewcoder-sdk) | [`@onpoint-dev-tools/crewcoder-sdk`](https://www.npmjs.com/package/@onpoint-dev-tools/crewcoder-sdk) | Node.js 22+ host process | Supported TypeScript API for embedding CrewCoder in-process, plus an authenticated fleet client for remote runners. | `npm install --global @onpoint-dev-tools/crewcoder-sdk` |
| [`crewcoder-client`](https://github.com/OnPoint-Dev-Tools/crewcoder/tree/main/crewcoder-client) | [`@onpoint-dev-tools/crewcoder-client`](https://www.npmjs.com/package/@onpoint-dev-tools/crewcoder-client) | Browsers, Electron renderers, webviews | Browser-safe client for authenticated CrewCoder runners. Web-platform APIs only: no Node.js imports, no local files, no tool execution, no stored provider credentials. | `npm install --global @onpoint-dev-tools/crewcoder-client` |

Package READMEs:
[agent](https://github.com/OnPoint-Dev-Tools/crewcoder/blob/main/crewcoder-agent/README.md) ·
[tui](https://github.com/OnPoint-Dev-Tools/crewcoder/blob/main/crewcoder-tui/README.md) ·
[opentui](https://github.com/OnPoint-Dev-Tools/crewcoder/blob/main/crewcoder-opentui/README.md) ·
[tui (legacy)](https://github.com/OnPoint-Dev-Tools/crewcoder/blob/main/crewcoder-tui/README.md) ·
[tui-core](https://github.com/OnPoint-Dev-Tools/crewcoder/blob/main/crewcoder-tui-core/README.md) ·
[sdk](https://github.com/OnPoint-Dev-Tools/crewcoder/blob/main/crewcoder-sdk/README.md) ·
[client](https://github.com/OnPoint-Dev-Tools/crewcoder/blob/main/crewcoder-client/README.md)

Expand Down Expand Up @@ -168,7 +173,8 @@ Run one workspace directly:
```sh
npm run dev -w @onpoint-dev-tools/crewcoder-agent
npm run typecheck -w @onpoint-dev-tools/crewcoder-sdk
npm run dev -w @onpoint-dev-tools/crewcoder-tui
npm run dev -w @onpoint-dev-tools/crewcoder-tui # legacy UI
mise exec node@26 -- npm run dev -w @onpoint-dev-tools/crewcoder-opentui # OpenTUI UI, Node.js 26.4+
```

## TypeScript SDK and browser client
Expand Down
Loading
Loading