CodeWork

CodeWork: Make Code Work for You

CodeWork is an open source AI coding agent for your terminal, editor or server.Add tools, prompts, skills and more as plugins, shared over npm or git.

alpha
$ curl -fsSL https://codework.sh/install | sh
Read the docsView on GitHub

An agent harness that: supports hundreds of models; you steer instead of restart; is small, and easy to extend; runs in any sandbox; works with ChatGPT Plus/Pro; works with GitHub Copilot; is not bloated.

CodeWork is open source, the way dev tools should be. Bend it to fit how you work and how your team ships.

CodeWork runs the agent, the sandbox and the models. Everything else is yours to shape: tools, skills, prompts and more, bundled as plugins and shared with your team over npm or git.

Start with the defaults and change them as you go. The docs cover how it's built and how to make it yours.

See it in action

devs love it. share yours, it might end up here.

Install CodeWork

The CLI runs your agent harness. The desktop app runs many sessions side by side.

Full installation guide

  1. 01CLI

    One command installs the standalone binary, or add the npm package.

    Quickstart
    alpha
    $ curl -fsSL https://codework.sh/install | sh

    The binary runs without Node.js on macOS (Apple silicon) and Linux (x64, ARM64).

  2. 02DesktopCanary

    Run many sessions side by side. Fresh builds, so expect a few rough edges.

    Verify the files with SHA256SUMS, or browse the release.

Any model, including the plan you pay for

Sign in with a ChatGPT or Copilot subscription, set an API key, or point it at a model on your own machine. Switch per run, per project, or mid-conversation.

Browse the model catalog
  • ChatGPT
  • GitHub Copilot
  • OpenRouter
  • Anthropic
  • OpenAI
  • Gemini
  • xAI
  • Ollama
  • LM Studio
  • vLLM
  • Your gateway
  • and more
.codework/settings.jsonc
{
  "plugins": [
    // Turn on a built-in search tool
    { "plugin": "codework.tool.grep", "enabled": true },
    // Add your own from npm, git, or a local file
    "@acme/codework-tool-proc@1.2.0",
    "github:acme/codework-prompt-style#v1.0.0",
    "./plugins/house-style.ts"
  ]
}

Everything is a plugin

The built-in tools are plugins too. Switch any of them off, or add your own tools and prompt sections from npm, git, or a file in your repo.

  • Tool plugins add or rewrite what the agent can do.
  • Prompt plugins shape the system prompt, the way AGENTS.md does.
  • Local TypeScript files load with no build step.
Write a plugin

One sandbox, wherever it runs

The agent only sees a filesystem and a shell. The sandbox decides where they live, so the same tools work on your machine, in memory, or in the cloud.

$ codework run --sandbox-driver memory "summarize data.csv"

Local

Your folder and your shell. The default, with full access to your machine.

  • local

Virtual

An in-memory filesystem and an emulated bash. No process ever runs on your machine.

  • memory
  • sqldb

Remote

A full Linux machine in the cloud, for untrusted code and long jobs.

  • daytona
  • vercel

CodeWork doesn't ask before it runs commands or edits files. Work in a git repository, or pick a sandbox.

About sandboxes

Get involved

GitHubIssues, bugs and pull requestsDocsHow it works and how to change itPostsAnnouncements and tutorialsChangelogWhat shipped, release by release