ace

ace is an agentic coding environment for running local coding-agent CLIs through one web, desktop, and remote-control workspace.

It starts provider CLIs behind a shared server, normalizes their runtime events, and streams session state to the UI over WebSocket.

The project is actively developed and already used as a daily coding workspace. Expect regular improvements as provider CLIs and desktop release flows evolve.

Providers

ace currently includes integrations for:

• Codex
• Claude
• Cursor
• Gemini
• GitHub Copilot
• OpenCode
• Pi

Provider CLIs are installed and authenticated separately. ace does not replace provider accounts or provider-specific auth flows.

Provider-specific features are implemented natively where ace can expose them cleanly. Codex currently has the deepest native integration, including plugins, skills, image generation, and Browser Use inside ace's in-app browser. More provider-specific capabilities are coming across Claude, Cursor, Gemini, GitHub Copilot, OpenCode, and Pi.

See FEATURES.md for the current feature map.

Quick Start

1. Install dependencies:

bun install

2. Install and sign in to at least one supported provider CLI:

Examples:

• Codex: codex login
• Claude: claude auth login
• Gemini: install Gemini CLI and sign in
• Cursor: install cursor-agent
• GitHub Copilot: configure through ace app settings; availability is checked through the Copilot runtime
• OpenCode: install opencode
• Pi: install the Pi CLI, for example npm install -g @mariozechner/pi-coding-agent

3. Check local setup:

bun apps/server/src/bin.ts doctor

4. Start the app:

bun dev:web

This starts the web app and local server together.

Desktop Releases

The Electron desktop app lives in apps/desktop.

Local all-platform desktop releases are documented in docs/release.md. The short path is:

# Build all desktop assets locally without publishing.
bun run dist:desktop:all -- --tag vX.Y.Z --create-tag

# Build, upload assets, and create/update the GitHub Release with changelog notes.
bun run release -- --tag vX.Y.Z

The local release flow reads .env.local automatically. Start from .env.local.example and keep real signing values out of git.

Generated release artifacts stay out of git. Use ignored release directories such as release/, release-local/, or release-*.

Mobile

The mobile app is in development in apps/mobile. It is part of the ace workspace direction for remote supervision and companion workflows, but the web and desktop apps are the primary daily-use surfaces today.

CLI

The ace CLI can start/open the app, manage the daemon, diagnose provider setup, control telemetry, inspect terminals, and manage local/remote runtime state.

Quick examples:

# Open the app (reuses or starts daemon)
ace web

# Check local setup
ace doctor

# Start daemon in background
ace daemon start

# Stop daemon (same as `ace daemon stop`)
ace stop

# Restart daemon
ace daemon restart

# Telemetry and runtime controls
ace telemetry off
ace telemetry status
ace daemon start --telemetry on

# Managed terminals
ace terminal list

Full CLI guide with first-run setup, diagnostics, telemetry/privacy controls, terminal management, remote pairing, troubleshooting, and automation examples:

• docs/cli.md

Development

Requirements:

• Bun 1.3.9 or compatible with package.json
• Node 24.13.1 or compatible with package.json
• at least one supported provider CLI installed locally

Common commands:

bun dev:web

• bun dev - full dev runner
• bun dev:web - web app + server
• bun dev:server - server only
• bun dev:desktop - desktop app
• bun dev:mobile - mobile app
• bun dev:marketing - marketing site
• bun fmt
• bun lint
• bun typecheck
• bun run test

Before considering a change complete, run:

bun fmt
bun lint
bun typecheck

Use bun run test for tests. Do not use bun test; the repo scripts route tests through Turbo/Vitest.

Architecture

• apps/server manages provider sessions, daemon lifecycle, CLI commands, and WebSocket routing.
• apps/web is the main React/Vite UI.
• apps/desktop wraps the app in Electron and owns native desktop lifecycle/update behavior.
• Provider runtime activity is projected into shared orchestration events for the client.
• Some internals are still Codex-first today, but the product and provider layer are designed to support multiple backends.

Repo Structure

• apps/web - React/Vite UI
• apps/server - WebSocket server and provider/session orchestration
• apps/desktop - Electron desktop shell
• apps/mobile - React Native / Expo mobile app
• apps/marketing - marketing site
• apps/relay - relay app
• packages/contracts - shared schemas and protocol types
• packages/shared - shared runtime utilities

Contributing

Small reliability, performance, cross-platform, and docs improvements are the easiest contributions to review. Open an issue before large features, provider integrations, or protocol changes.

See CONTRIBUTING.md.

Community and maintainer process:

• Code of Conduct
• Security Policy
• Support
• Governance
• Maintainers
• GitHub triage and protection

License And Attribution

ace is released under the MIT License.

This project began as a fork of T3 Code by T3 Tools Inc. and is now maintained as ace by arpan404.