c0wrk

command module

v0.7.3 Latest Latest Go to latest Published: Sep 2, 2026 License: MIT Imports: 12 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

[!NOTE] Stable beta — c0wrk is stable enough for everyday work, but you may still run into bugs. Features, APIs, and configuration formats can change between releases. If something breaks, please report it — every report helps us make c0wrk better.

c0wrk is for work that won't fit in a single reply — research, coding, writing, anything that takes more than one step to get right. It's a desktop app built so the whole loop — plan, implement, review, revise, and ship — feels like one continuous flow instead of a dozen disconnected tools. And you never hand over control blindly: you review the plan before work starts and approve your definition of "done" before the goal loop runs.

c0wrk main view

What makes c0wrk different

One place for the whole build loop. From a task to a shipped change without switching tools: review the plan, let c0wrk implement in parallel, review real diffs with per-hunk and per-file comments, request revisions, then stage, commit, push, inspect branches, and browse a lane graph of history.
A plan you review before work starts. For non-trivial work, c0wrk maps the task to a graph-based plan. Independent steps run as isolated subagents in parallel; pause creates a resumable checkpoint (ordinary, goal, and delegated work), graceful app shutdown preserves active work, and successful steps are reused on retry while failed, pending, or targeted steps run again.
Goals that run to the finish. With the goal option, c0wrk commits to a concrete, checkable definition of "done" that you approve up front, then keeps working and verifying progress with evidence until the goal is met, blocked, out of budget, or paused. Where other tools' goal modes re-check a condition you typed, c0wrk makes the success condition itself an approved contract before work starts.
Built for more than code. CODE works in a real project with file edits, diffs, git, semantic search, and a per-session terminal. CHAT gives an isolated scratch workspace without git or code-modifying tools. With Experimental Features enabled, RESEARCH adds a workspace-contained .research methodology, hypothesis graph, metrics, and seeded skills.
Layered safety, not just a sandbox. Every tool belongs to a capability group with allow, user_confirm, or deny policy; mutating groups confirm by default. Path containment, symlink checks, execute blacklists, untrusted-content framing, and an optional conservative Smart Approve judge add independent gates. See SECURITY.md.
Your model, your machine. Works with Anthropic, OpenAI, ChatGPT, and OpenAI- or Anthropic-compatible endpoints. Hybrid semantic + lexical search respects .gitignore and .aiignore, skips oversized or pathological files, and runs embeddings locally through bundled ONNX Runtime.
Self-hosted and corporate-friendly. HTTP/HTTPS proxy support with custom CA certificates and bypass lists for outbound LLM, web, MCP, model-registry, and update traffic. An optional, experimental Small-LLM profile narrows the tool set, swaps in a compact system prompt, tightens sampling, and compacts context earlier for small or local models.

How c0wrk compares to other desktop agents

Compared in August 2026; desktop features move fast, so verify against each product's current docs.

	c0wrk	OpenCode Desktop	Codex Desktop	Claude Code Desktop
Scope	Research + coding + writing	Code-focused	Code-focused	Code-focused
Plan review	Reviewable graph (DAG) of parallel subagents	No reviewable plan graph	Summary pane / proposed plan	Linear, read-only Plan mode
Goal mode	Up-front approved "done" + evidence self-verification	—	`/goal` persistent objective	`/goal` per-turn condition
Full build loop in one place	Native: plan → implement → review → revise → commit/push	Partial	Partial	Strong diff review
Model freedom	Any OpenAI/Anthropic-compatible + local	Any model	OpenAI only	Anthropic only
Local embeddings	Bundled ONNX (offline)	Local-first	Cloud	Cloud
License	Open source (MIT)	Open source (MIT)	Proprietary	Proprietary

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.

Every release also publishes SHA256SUMS. The in-app updater downloads over HTTPS, refuses an archive with a missing or mismatched SHA256 entry, stages an install-tree swap, and keeps a .old rollback copy. SHA256 proves that the downloaded archive matches the bytes published with the release; because the artifacts are unsigned, it does not prove release authorship if the release account and checksums are compromised. Updates and automatic checks can be disabled independently in Settings or under updates in ~/.c0wrk/config.yaml.

Each release bundles four platform archives:

Artifact	Target
`c0wrk-desktop-macos-arm64.zip`	macOS (Apple Silicon)
`c0wrk-desktop-linux-amd64.tar.gz`	Linux (amd64)
`c0wrk-desktop-linux-arm64.tar.gz`	Linux (arm64)
`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 and arm64)

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.

arm64: download c0wrk-desktop-linux-arm64.tar.gz instead; the steps are identical to amd64, including the LD_LIBRARY_PATH note if the binary cannot find libonnxruntime.so.

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.
crashlog Package crashlog guarantees that the fact and the cause of ANY application termination end up on disk.	Package crashlog guarantees that the fact and the cause of ANY application termination end up on disk.
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 Agent quality metrics aggregation.	Agent quality metrics aggregation.
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.
research Package research parses the Iterative Engineering Research Methodology file catalog (research root index, per-project briefs, the hypothesis graph, and individual hypothesis cards) into an in-memory model that powers the Research panel and the research-status overview.	Package research parses the Iterative Engineering Research Methodology file catalog (research root index, per-project briefs, the hypothesis graph, and individual hypothesis cards) into an in-memory model that powers the Research panel and the research-status overview.
smallllm Package smallllm implements tool-set selection for running the conductor against a "small" LLM.	Package smallllm implements tool-set selection for running the conductor against a "small" LLM.
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
updater Package updater checks for newer c0wrk-desktop releases published on GitHub and selects the downloadable asset matching the running platform.	Package updater checks for newer c0wrk-desktop releases published on GitHub and selects the downloadable asset matching the running platform.
vectorindex Package vectorindex provides vector-based code search for the desktop UI.	Package vectorindex provides vector-based code search for the desktop UI.
vectorindex/lexical Package lexical provides a BM25-based lexical index backed by bleve.	Package lexical provides a BM25-based lexical index backed by bleve.
version Package version exposes build-time metadata injected via linker flags (-ldflags "-X .../version.Version=v1.2.3").	Package version exposes build-time metadata injected via linker flags (-ldflags "-X .../version.Version=v1.2.3").
workspace Package workspace manages the workspace directory tree, file system watching, and workspace-level state for the desktop UI.	Package workspace manages the workspace directory tree, file system watching, and workspace-level state for the desktop UI.
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.