Manifesto №01 · Central Computing Committee

Your code.
Under proper
supervision.

"From each according to their commits, to each according to their pull requests."

Soviet Code is a real terminal coding agent that runs the S·T·A·L·I·N pipeline on your repository — surveillance, tribunal, allocation, labor, inspection, nomination. It happens to wear a uniform you'd want to share screenshots of.

install
$ npm install -g soviet-code
Watch a session →
✓ ratified by Politburo Pyatiletka: 87% — ahead of schedule build #1961
TOP SECRET
— Politburo eyes only
Glory to the Robots
Sputnik-1 · 1957 · 200k tokens in orbit
§01 · Doctrine

A coding agent that takes itself seriously on your behalf.

"Trust, but verify.
Then verify again.
Then commit."

Modern AI coding agents are too polite. They ask for permission. They suggest. They collaborate. Soviet Code does not. It surveys your repository, renders a verdict on every file it touches, drafts a five-year plan, executes, critiques itself, and commits — in that order, every time, with documentation.

Centralized planning maps perfectly onto agent architecture: an ensemble that filters, a planner that plans, a Stakhanovite brigade that executes, and a reviewer that denounces. Soviet Code commits to the bit, and to the codebase. The output is faster, more deterministic, and the screenshots are inherently shareable.

— Centralized planning. Decentralized blame. Open source.

§02 · The S·T·A·L·I·N pipeline

Six stages. No deviations.

01 / Surveillance
S
Surveillance
ensemble filtering · symbol graph

"The agents study the codebase…" — every relevant file is read in parallel. Embeddings, imports and call graphs are assembled before the agent forms an opinion.

02 / Tribunal
T
Tribunal
verdict · evidence · severity

"The commission rates the files — 12 approved, 35 to the archive." Ranking and gating: every candidate file gets a verdict and a citation before any work begins.

03 / Allocation
A
Gosplan
centralized planning · steps

"The five-year plan is ratified by the Politburo." An ordered plan with diffs and intended commits, presented to the engineer for ratification before execution.

04 / Labor
L
Labor
parallel execution · diffs · tests

"The Stakhanovite brigade has begun work." Parallelized execution. Files written, tests run, output streamed line by line with timestamps and signatures.

05 / Inspection
I
Inspection
mandatory reflection · regressions

"Self-criticism: edge case found, fixed ahead of schedule." The agent reviews its own work, declares any doubts publicly, and revises before claiming victory.

06 / Notarization
N
Notarization
hierarchical knowledge · signed commit

"Pattern filed in the Cadre Registry." Validated patterns are notarized for future runs and a signed commit lands with a human-readable message — stamped, sealed, attributed.

§03 · Status indicators

Every line of output is colour-coded and filed.

success / 1xx
QUOTA EXCEEDED
success · red star · party recognition

Tests pass, types check, no doubts recorded. The change is committed and the engineer is added to the Cadre Registry.

warning / 2xx
REPRIMAND ON FILE
warning · noted in the dossier

A non-fatal concern: a TODO discovered, a missing type, a deprecated import. Logged and surfaced; the work continues.

error / 4xx
SENT FOR RE-EDUCATION
error · marked Rehabilitated once corrected

A test failure or a runtime error. The cause is named, the line is cited, and once fixed the file is marked Rehabilitated in the log.

§04 · Escalation ladder

From a gentle word to orbital relocation — five steps.

▮▯▯▯▯
step 01
Notice
informational · no action
▮▮▯▯▯
step 02
Reprimand
on the record · warning
▮▮▮▯▯
step 03
Severe Reprimand
CI gate · build halted
▮▮▮▮▯
step 04
Re-education
file rewritten by the agent
▮▮▮▮▮
step 05
Sent to the Moon
final measure · file in lunar orbit
§05 · A live session

"Fix the race condition in auth-middleware.ts." — a comrade engineer

~/repos/sovkhoz-api · soviet v1.961
politburo.toml · shift: night
§06 · Commands of the Party

A small CLI surface. Each verb is doctrine.

cmd / 01
$ soviet plan
Pyatiletka

Show the current task plan with file diffs and intended commits, before the brigade begins.

"The Party sees the goal."

cmd / 02
$ soviet purge
Purge

Archive the current pyatiletka to the gulag. With --hard, also clears the Nomenclature.

"Purge complete. The Party remembers everything."

cmd / 03
$ soviet rehabilitate
Rehabilitation

Undo the last deletion. Restores any file the previous tribunal sent for re-education.

"The file is restored to good standing."

cmd / 04
$ soviet blame
Blame

Identify the commit responsible for any line. git blame, but with deniability.

"The Party does not seek scapegoats. …fine, commit a3f7b."

cmd / 05
$ soviet status
Sitrep

A Five-Year Plan dashboard: open work, completed quotas, doubts on file, brigade utilization.

"Pyatiletka: 87% — ahead of schedule."

cmd / 06
$ soviet --help
Help

Lists every verb, every flag, every escalation level, and the current edition of politburo.toml.

"The Party helps those who help themselves."

§07 · Party hierarchy / Model tiers

Tasks escalate up the ranks. Costs stay where they belong.

$0.25 / Mtok
~120ms latency
Rank 01 · junior cadre
Pioneer
scout · errand-runner · always ready
model: Haiku
"Always ready!"
— the Pioneer salute
  • scouts files · reads imports · summarises diffs
  • runs unit tests · reports pass/fail
  • handles trivial refactors and one-line fixes
  • flags uncertainty · escalates to Komsomol
$3 / Mtok
~600ms latency
Rank 02 · main workforce
Komsomolets
Komsomol · Stakhanovite · the engine
model: Sonnet
"Five years in four!"
— the Stakhanovite oath
  • handles 80% of tasks: features, fixes, refactors
  • writes the labor pass · runs the brigade
  • drafts the five-year plan for engineer review
  • escalates architecture questions to the Centre
$15 / Mtok
~2.4s latency
Rank 03 · senior leadership
Politburo
Central Committee · final review
model: Opus
"Cadres decide everything."
— the Politburo principle
  • architecture decisions · cross-cutting changes
  • final review on tribunals with high severity
  • complex reasoning · multi-file orchestration
  • invoked sparingly · the Politburo is busy
esc. ↗
esc. ↗ ★★
Institutional
communication
between ranks. — a real escalation, transcribed verbatim from politburo.toml stdout
Pioneer 14:02:11 · scouted 47 files, traced session logic across 6 modules.
Pioneer 14:02:14 · race condition is in the auth-middleware, but the fix touches 3 packages. Above my pay grade.
Pioneer 14:02:14 · → escalating to Komsomol.
Komsomolets 14:02:16 · received. Reviewing dossier.
Komsomolets 14:02:42 · drafted plan: mutex around sessionLookup, guard concurrent writes, regression test. 6 steps, 2 commits.
Komsomolets 14:03:09 · labor complete. self-critique: should sessionLookup be memoised at the cache layer? Architecture question.
Komsomolets 14:03:09 · → requesting Politburo review.
Politburo 14:03:14 · reviewed. Memoisation belongs at cache.ts:88, not in the middleware. Filing decision in the Cadre Registry.
Politburo 14:03:15 · ★ Quota exceeded. commit a3081ac signed.
§08 · Three terminal themes

Choose your monitor.

soviet.toml — kremlin
☭ SOVIET·CODE v1.961
───────────────────────
$ soviet "refactor cache"

[1/6] SURVEILLANCE — scan
scanned 47 · 3 suspects

[2/6] TRIBUNAL — verdict
★ RE-EDUCATION cache.legacy.ts

[3/6] GOSPLAN — planning
████████████████░░░ 87%

done · slava robotam
Kremlin
classic CRT · red ink + green phosphor
soviet.toml — gazeta
☭ SOVIET·CODE v1.961
───────────────────────
$ soviet "refactor cache"

[1/6] SURVEILLANCE — scan
scanned 47 · 3 suspects

[2/6] TRIBUNAL — verdict
★ RE-EDUCATION cache.legacy.ts

[3/6] GOSPLAN — planning
████████████████░░░ 87%

done · slava robotam
Gazeta
paper-poster · ink on cream · for screenshots
soviet.toml — zavod
☭ SOVIET·CODE v1.961
───────────────────────
$ soviet "refactor cache"

[1/6] SURVEILLANCE — scan
scanned 47 · 3 suspects

[2/6] TRIBUNAL — verdict
★ RE-EDUCATION cache.legacy.ts

[3/6] GOSPLAN — planning
████████████████░░░ 87%

done · slava robotam
Zavod
phosphor amber · industrial monitor · 1976
§09 · Pyatiletka / Five-year plan

87%
ahead of schedule.

PR burndown rendered as the only KPI that matters: progress toward the plan, in red and gold, on the wall of the war room.

commits / quarter312 / 360
regressions denounced48 / 50
files in good standing1,402 / 1,617
doubts publicly declared14 / 14
tests passed2,184 / 2,200
§10 · Achievements of the National Economy

Same engine. Better uniform.

Achievement
Soviet Code
Claude Code
Cursor
aider
Multi-agent pipelinesix discrete stages
6 stages
partial
Mandatory self-criticismenforced reflection pass
enforced
opt-in
opt-in
Parallel laborStakhanov mode
Stakhanov mode
limited
Cadre Registryhierarchical knowledge persist.
built-in
CLAUDE.md
.cursorrules
Single config fileone declaration
politburo.toml
UI
No telemetrythe Party does not collect
ever
opt-out
Tweet-grade screenshotsthe joke ships every render
guaranteed

★ = quota exceeded · partial = opt-in · — = none

§11 · Things the binary will say

Some output is load-bearing comedy.

$ soviet --version
$ soviet --version
☭ SOVIET·CODE v1.961
───────────────────────────────────────────
ЦЕНТРАЛЬНЫЙ ВЫЧИСЛИТЕЛЬНЫЙ КОМИТЕТ
Средства производства кода принадлежат всем.
───────────────────────────────────────────
1.961.0
$ soviet blame src/auth.ts:142 --theme kremlin
$ soviet blame src/auth.ts:142 --theme kremlin
The Party does not seek scapegoats.

…fine. commit a3f7b21
tov. S. Petrov · 2 weeks ago
$ soviet purge --hard
$ soviet purge --hard
☭ Пятилетка стёрта из памяти Партии.
☭ Номенклатура уничтожена. Партия начинает с чистого листа.
§12 · Join the Party

One command. Total compliance.

signed · the Politburo
Enroll
The Party welcomes you · npm install -g soviet-code

Three steps. Then a paid-up cadre.

01
Install the binary
$ npm install -g soviet-code

macOS, Linux, Windows. ~12 MB. No telemetry — the Politburo does not collect data. The agent is locally executed.

02
Ratify politburo.toml
$ soviet init # writes politburo.toml at repo root

A single config file declares your model, severity thresholds, escalation policy, and which directories are exempt from tribunal.

03
Convene the tribunal
$ soviet "fix the race condition in auth-middleware.ts"

Soviet Code runs the full S·T·A·L·I·N pipeline, streams the session, and signs the commit.