yakcc

AI coding assistants regenerate the same functions on every prompt. yakcc gives them a shared, verified library to pull from instead — across TypeScript, Python, and Go.

npm install -g @yakcc/cli@alpha

Requires Node 18+. Paste into your terminal.

Alpha — currently @yakcc/cli@0.5.0-alpha.2. This is pre-release software; APIs and atom schema will change before 1.0.  View latest GitHub Release →

What is yakcc?

When an AI assistant in your editor needs a small function — to parse a date, validate an email, debounce a callback — it generates the code from scratch every time. The same dozen functions get reinvented across every codebase, each with subtle differences, each verified only by the tests you happen to write, each shipped to your users as part of your bundle.

yakcc is a shared library of those functions. Each piece — we call them atoms — comes with a stated contract, a small implementation, and property tests that prove the implementation matches the contract. When the AI in your editor reaches for "a function that validates an email," yakcc serves the verified atom that already exists instead of letting the AI generate a new one.

Atoms are identified by the hash of their content, so the same logical function always has the same identity — no matter who wrote it or when. They work across TypeScript, Python, and Go through a single shared format. The library is offline-first: the whole pipeline runs without ever touching the network. The public registry grows as developers contribute new atoms; every atom contributed once is available to everyone, forever.

Current status

Honest accounting of what is proven, what is in flight, and what is not yet built.

Working

  • Offline-first. The full pipeline — install, shave, query, compile, verify — runs with zero outbound network calls. Regulated environments work fine.
  • Bundle reduction. A JSON schema validator built from yakcc atoms ships ~1/10th the bytes of the equivalent npm dependency, on the same 156-case test suite.
  • Import replacement. When the AI's instinct is import validator from 'validator', yakcc swaps in a 6-function atom — 98.8% fewer reachable functions, same correctness.
  • Verified reproducibility. yakcc proves bit-for-bit identity by re-shaving its own source code on every commit. All 7,064 of its own atoms match byte-for-byte between the two passes.
  • Cross-language support. The same atom binds into TypeScript, Python, and Go. 9 BeautifulSoup functions and 51 lodash-equivalent (samber/lo) functions round-trip end-to-end.
  • Mathematical proofs of behavior. Every atom ships with property tests that prove the implementation matches the contract — not just the cases you happened to think of.

In flight

  • Multi-turn conversation coherence. Active measurement work; current results below target bar.
  • Editor-side discovery hook. Wiring atom discovery into the AI assistant's lifecycle so it consults yakcc before generating code, not after — tracked in #950.

Not yet

  • Rust support. Tracked in #868 and #869.