c0wrk

command module

v0.3.1 Latest Latest Go to latest Published: Jul 24, 2026 License: MIT Imports: 10 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/v0lka/c0wrk

Links

Open Source Insights

README ¶

c0wrk

[!WARNING] Early Alpha Stage — This project is under active development and not yet stable. Features, APIs, and configuration formats may change without notice. Use at your own risk.

A desktop AI agent for work that won't fit in a single reply — research, coding, writing, anything multi-step.

c0wrk main view

What makes c0wrk different

Tackles genuinely hard, multi-part tasks. Rather than answering in one shot, c0wrk plans the work, takes it step by step, and replans when something goes wrong, so a complicated request gets carried all the way to a finished result.
Goals that run to the finish. Start a message with /goal and c0wrk commits to a concrete, checkable definition of "done" that you sign off on up front — then keeps working turn after turn, checking its own progress, until it can prove the goal is met, it's stuck, the budget runs out, or you hit pause. No stopping at the first plausible-looking answer.
A real desktop workspace. Chat sits next to a file tree, a code viewer with inline diffs, and live panels that show what the agent is doing and why.
Two modes for two kinds of work. CODE points the agent at a real project: full toolset, in-place file edits, inline diffs, and git. CHAT is for when you want to reason, research, or draft without touching a codebase — each CHAT session gets its own isolated scratch workspace, code-modifying tools are switched off, and no git is required.
You stay in control. Every potentially risky action can require your approval, with an optional AI "judge" that reasons about borderline calls so you're not drowned in prompts — or drowned in risk.
Defense in depth. The agent stays inside your project workspace by default; any step outside it — reading or writing files elsewhere on disk — needs your explicit OK. Shell commands go through a hardened denylist (tighter still in CHAT mode), web fetches are SSRF-protected, and every safety check runs before an operation can auto-approve.
Bring your own model. Works with Anthropic, OpenAI, ChatGPT, Gemini, LM Studio, and any OpenAI- or Anthropic-compatible endpoint. Set it up once, switch models per task.
Connects to your tools. Plug in external services through the Model Context Protocol (MCP), extend behaviour with composable agent skills, and run shell commands directly in a built-in terminal.
Knows your codebase. Semantic + keyword search means c0wrk finds the right file or symbol even when you describe it loosely, not just when keywords happen to match.
Picks up where you left off. Full session history is persisted, so you can close the app and resume a task exactly as it was.
Searches the live web. Pulls up-to-date information via Tavily when the task needs current knowledge.
Plays nice with corporate networks. HTTP/HTTPS proxy support with custom CA certs and bypass lists.

Download & install

Prebuilt desktop builds are published on the GitHub Releases page. Builds are currently unsigned — see the per-OS notes below for the one-time workaround.

Each release bundles three artifacts:

Artifact	Target
`c0wrk-desktop-macos-arm64.zip`	macOS (Apple Silicon)
`c0wrk-desktop-linux-amd64.tar.gz`	Linux (amd64)
`c0wrk-desktop-windows-amd64.zip`	Windows (amd64)

The ONNX Runtime library and the embedding models ship inside every archive, so vector search works without an extra download on your end.

macOS (Apple Silicon)

Download c0wrk-desktop-macos-arm64.zip and unzip it.
The app is unsigned, so macOS Gatekeeper will block first launch. Clear the quarantine attribute:
```
xattr -cr /path/to/c0wrk-desktop.app
```
Alternatively, right-click c0wrk-desktop.app → Open on first launch, then confirm in the Gatekeeper dialog.
Launch c0wrk-desktop.app.

Linux (amd64)

Download c0wrk-desktop-linux-amd64.tar.gz and extract it:
```
tar -xzf c0wrk-desktop-linux-amd64.tar.gz
```
Run the binary:
```
./c0wrk-desktop
```
If the binary can't find libonnxruntime.so, run it from the extraction directory or add that directory to LD_LIBRARY_PATH.

Runtime dependencies (end users only need these shared libraries, not the -dev packages):

# Ubuntu/Debian
sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0

Windows (amd64)

Download c0wrk-desktop-windows-amd64.zip and extract it.
The app is unsigned, so Windows SmartScreen may warn "Windows protected your PC". Click More info → Run anyway.
Run c0wrk-desktop.exe.

On first launch c0wrk creates its config automatically, then — once all runtime dependencies are in place — opens a dialog to set up an LLM provider.

Contributing

Interested in hacking on c0wrk? Architecture, build instructions, and the release process live in CONTRIBUTING.md.

License

Licensed under the MIT License.

About

Built by the c0wrk team with warmth, love, and c0wrk.

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
backend
config Package config provides configuration loading and validation for the agent.	Package config provides configuration loading and validation for the agent.
logger Package logger provides a thin wrapper around Go's standard log/slog for writing structured logs to a session file.	Package logger provides a thin wrapper around Go's standard log/slog for writing structured logs to a session file.
project Package project provides project-scoped persistence and lifecycle management for the desktop UI layer.	Package project provides project-scoped persistence and lifecycle management for the desktop UI layer.
review Package review provides SQLite-backed persistence for the per-session code review buffer (a general comment plus hunk-scoped comments) and its lifecycle status.	Package review provides SQLite-backed persistence for the per-session code review buffer (a general comment plus hunk-scoped comments) and its lifecycle status.
session Package session provides session-scoped event emission for the desktop UI.	Package session provides session-scoped event emission for the desktop UI.
core Package core provides the orchestration engine that routes, plans, executes, evaluates, and reflects on agent tasks.	Package core provides the orchestration engine that routes, plans, executes, evaluates, and reflects on agent tasks.
goal Package goal defines the Goal domain: the user's declared success condition, the budget that constrains how much work the agent may spend reaching it, and the runtime state machine that tracks progress toward (or away from) that condition.	Package goal defines the Goal domain: the user's declared success condition, the budget that constrains how much work the agent may spend reaching it, and the runtime state machine that tracks progress toward (or away from) that condition.
markitdown Package markitdown converts supported documents to Markdown by shelling out to the managed markitdown CLI (pre-installed at ~/.c0wrk/tools/bin and prepended to PATH during application startup).	Package markitdown converts supported documents to Markdown by shelling out to the managed markitdown CLI (pre-installed at ~/.c0wrk/tools/bin and prepended to PATH during application startup).
prompts Package prompts provides embedded prompt templates used by LLM agents.	Package prompts provides embedded prompt templates used by LLM agents.
proxy Package proxy provides HTTP proxy infrastructure for c0wrk LLM API clients.	Package proxy provides HTTP proxy infrastructure for c0wrk LLM API clients.
terminal Package terminal provides PTY-based shell session management for the desktop UI.	Package terminal provides PTY-based shell session management for the desktop UI.
toolmanager Package toolmanager manages the lifecycle of external CLI tools required by c0wrk at runtime.	Package toolmanager manages the lifecycle of external CLI tools required by c0wrk at runtime.
tools
vectorindex
vectorindex/lexical Package lexical provides a BM25-based lexical index backed by bleve.	Package lexical provides a BM25-based lexical index backed by bleve.
workspace
desktop Package desktop implements the Wails desktop application layer.	Package desktop implements the Wails desktop application layer.
internal
shellresolver Package shellresolver provides a shared shell binary resolution function used by both the config (shell environment loading) and terminal (PTY session) packages.	Package shellresolver provides a shared shell binary resolution function used by both the config (shell environment loading) and terminal (PTY session) packages.
sysproc Package sysproc configures process-creation attributes for child processes spawned by the GUI application.	Package sysproc configures process-creation attributes for child processes spawned by the GUI application.