▣
One file = one agent
Statically compiled with Cangjie cjnative: 17.1 MB on Linux, 14.2 MB Windows exe, no Node or Python runtime. Download, chmod, run.
Cangjie · Coding Agent Harness
A terminal coding agent
written in Cangjie
Say what you want once — the agent plans, calls tools, reads results and iterates until the job is done, all visible live in the TUI, or driven remotely from the built-in web UI. One static binary, zero dependencies — one file is the whole agent.
- 17.1 MBstatic binary
- 715unit tests green
- 0runtime dependencies
- 6publishable libraries
# No API key needed: mock mode runs the whole loop
$ curl -LO https://api.atomgit.com/api/v5/repos/qq8864/cjh/releases/v1.6.5/attach_files/cjh-v1.6.5-linux-x64
$ chmod +x cjh-v1.6.5-linux-x64
$ CJH_MOCK=1 ./cjh-v1.6.5-linux-x64
# Point it at a real model (any provider key)
$ export DEEPSEEK_API_KEY=sk-xxx
$ ./cjh-v1.6.5-linux-x64LanguageCangjie 仓颉
FormTUI + Web + headless JSON
ProvidersOpenAI / DeepSeek / GLM / Anthropic / Ollama
ChannelsAtomGit · GitHub
Why this one
No feature bloat. Two hard targets — spend fewer tokens, run faster — packed into a binary you never install.
✂
Fewer tokens: truncate, spill, recall
Oversized tool results keep head and tail; the middle is spilled verbatim to ~/.cjh/spill/ with the path in the elision marker, so the model can read_file it back. Cheaper without losing information.
⚡
Faster execution: DAG concurrency
Each tool call yields (path, isWrite) resources, which build a dependency graph; topological groups run spawn-concurrently inside a group and serially across groups, with parallelSavedMs reporting the time actually saved.
▤
Diff-rendered TUI
Hand-written termios + ANSI diff refresh over raw libc FFI, no third-party terms: Markdown, / command completion, 10 themes, side-by-side Tasks/Agents panels, queued approvals for risky actions.
◍
Drive it from the browser
A built-in HTTP server with WebSocket streaming, a REST API and a bundled SPA drives the same agent remotely. Token auth and a startup security audit are on by default.
⊕
Plugin trust chain
Skills are just Markdown and plugins may ship tools; SHA256 checksums plus SM2 signatures (native stdx.crypto) cover the supply chain from the language layer up.
⧉
Parallel subagents, under control
The task tool spawns explore/worker subagents concurrently, watched live in the bottom-right Agents panel — bounded by concurrency/token/time budgets, with staggered starts and throttle backoff so 5-way fan-out survives real-provider rate limits.
✦
Embed an agent in your app
One command turns cjh into a REST + WebSocket service with crash isolation — verified integrations include the ai-chat client and the cjnote notebook app. Frame order and field-tested pitfalls in the repo's integration guide.
Screenshots
A full-screen TUI in the terminal, and a live stream in the browser.
Quickstart in 30 seconds
Run it before paying anything: mock mode needs no network and no API key, and still walks the full loop.
① Try it with zero keys (mock)
curl -LO https://api.atomgit.com/api/v5/repos/qq8864/cjh/releases/v1.6.5/attach_files/cjh-v1.6.5-linux-x64
chmod +x cjh-v1.6.5-linux-x64
CJH_MOCK=1 ./cjh-v1.6.5-linux-x64② Attach a real model
export DEEPSEEK_API_KEY=sk-xxx # or OPENAI_API_KEY / DASHSCOPE_API_KEY / CJH_API_KEY
./cjh-v1.6.5-linux-x64 # TUI by default; --cli plain text; --mode json headless
./cjh-v1.6.5-linux-x64 web --port 8765 --token my-secret # web UI③ Windows
# Unzip cjh-v1.6.5-windows-x64-selfcontained.zip first
# the exe and its 4 DLLs must stay in the same directory
cjh-v1.6.5-windows-x64.exeBuilding from source? See the README: Cangjie SDK 1.0.5+, cjpm build produces the static binary and ./scripts/test.sh runs the full suite.
Download v1.6.5
Prebuilt for Linux and Windows, ready to run. All releases →
Linux x6417.1 MB
cjh-v1.6.5-linux-x64
Static single file,
chmod +x and run. Needs glibc ≥ 2.34.sha256 bdda51cdce93d8cc…
Windows x64 · recommended7.9 MB
cjh-v1.6.5-windows-x64-selfcontained.zip
Exe plus the 4 runtime DLLs — unzip and go.
sha256 c861a762e4083470…
Windows x64 · exe only4.9 MB
cjh-v1.6.5-windows-x64.zip
Just the executable; bring the runtime DLLs yourself.
sha256 41a36f62ed9e7375…
Need the tarball or full checksums? See dist/SHA256SUMS in the repository.
Traces left upstream
Not just "an agent written in Cangjie": the potholes became documentation and the confirmed defects went back to the language team — each with a minimal reproduction, not a hunch.
▦
56 documented pitfalls
1000+ lines covering FFI, conditional compilation, static linking, concurrency and locks, TLS, terminal encoding and artifact verification — each with symptoms, hard evidence and a reusable recipe. Read the notes →
◫
6 publishable libraries
cjterm / cjlog / cjconfig / cjcfg / cjutil / cjllm: zero dependencies or official stdx only, each with its own README, examples and MIT licence — ready to contribute separately.
⚑
12 upstream defect reports
Filed to Cangjie/UsersForum as #3473–#3484 (defects and proposals); all triaged and answered by the language team. See the issue →
⚖
cjpm test crashes under static linking
Builds fine, then the test binary exits with SIGSEGV / double free; the same project switches to dynamic linking and goes 441/441 green, pinning it to static linking plus the test macros. #3473 →
◱
No pure static exe on Windows
The same --static* flags: Linux yields a dependency-free single file, Windows neither errors nor takes effect (output size and PE imports match the dynamic build), and the SDK ships no static runtime. #3484 →
⟲
Willing to overturn our own findings
Re-checking community feedback corrected three of our earlier claims: connect(timeout:) does work, the default spawn stack is complete, and Directory.removeIfExists is a top-level function. Measurement beats memory.
Documentation
Source and docs live in the same repository, and the key designs record their "why".
Feature listAgent loop / tools / themes / plugins / MCP / platforms
ChangelogAdditions, fixes and tests per version
Dev notes & pitfalls56 real pitfalls and how each was pinned down
Cross-platform terminal layerPOSIX / Win32 conditional compilation, unified VT
Progress logStage goals and measured numbers
READMEEnglish overview; 中文版见 README.zh-CN.md
One file is the whole agent
17 MB download, no runtime to install. Questions and ideas — open an issue.