frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

Show HN: sudocode – manage specs, tasks, and context-as-code for coding agents

https://github.com/sudocode-ai/sudocode
15•alexsngai•16h ago
sudocode is a lightweight context management system for coding agents that lives in your repo. It helps organize the chaos of human-AI collaboration by capturing user intent as durable specs and tracking agent activity as issues, all version-controlled with Git. This "context-as-code" approach reduces agent amnesia and accelerates development on long-horizon tasks.

Comments

arcticampic•16h ago
nice
ishita159•16h ago
have tried it, i think's focusing on spec-driven development?
alexsngai•15h ago
yes! sudocode manages agents at different levels of abstraction. You can steer agents at the `spec` level by building up a spec that contains your intent and requirements, then generate `issues` that capture the implementation details. However you aren't limited to that pattern. You can also just manage agents at the `issue` level to better manage their execution state (think something like a kanban board).

In general, sudocode aims to preserve some of this implementation/planning state (context-as-code) in your codebase so it isn't lost in your chat logs. Keeping this context in your repo makes it accessible to coding agents long after code changes were made, so it functions as a sort of episodic memory for your codebase.

wintonzheng•15h ago
Does "durable spec" mean writing the spec in a MD file and committing to a repo?

The big problem of ai generated docs for me is that it takes time to read and understand whether they are correct or not. Same with human written docs, which is why you need spec reviewers.

I assume the purpose of sudocode is to help me reduce the time to review and manage specs. How can sudocode help me solve the trust problem here while i don't want to spend so much time reading and managing specs? Solving the spec generation is one part, but the other big problem to solve here is to help speed up the spec review/validation process.

alexsngai•15h ago
I think of specs as a combination of user intent + context that might be relevant for the issue. The expansion of the spec into a full-fledged document, whether thats agent-written or human-written can be flexible as long as it contains the original user intent and requirements (so it becomes useful input to any coding agents handling the implementation).

In this case, what sudocode aims to preserve is the human intent that might be lost in agent chat logs, etc. It then provides utilities to turn those specs into implementation plans (issues). And specs in this case are mutable and designed to be iterated on (just like code).

Or with a physics analogy, the code is the position of a particle while the specs capture velocity information. You can iteratively work on changing the velocity which will then change the position (code changes).

As for the spec review burden, the sudocode provides an interface for coding agents to provide bi-directional feedback onto the original spec, so you can fire off a few coding agents and see how they performed relative to your specified requirements. You can let the execution of the coding agents speak for themselves!

Show HN: qqqa – a fast, stateless LLM-powered assistant for your shell

https://github.com/matisojka/qqqa
3•iagooar•11m ago•1 comments

Show HN: Flutter_compositions: Vue-inspired reactive building blocks for Flutter

https://github.com/yoyo930021/flutter_compositions
19•yoyo930021•4h ago•7 comments

Show HN: fx - A (micro)blogging server that you can self-host

https://github.com/rikhuijzer/fx
2•huijzer•51m ago•0 comments

Show HN: I made a MVP development agency and want your feedback on the site

https://mintmvp.com/
2•alwassikhan•3h ago•0 comments

Show HN: Standards compliant SAX-style XML parser for JavaScript

https://github.com/federicocarboni/saxe
2•federicocarboni•3h ago•0 comments

Show HN: Data Formulator 0.5 – Vibe with your data (Microsoft Research)

https://data-formulator.ai/
3•chenglong-hn•4h ago•0 comments

Show HN: The Legal Embedding Benchmark (MLEB)

https://huggingface.co/blog/isaacus/introducing-mleb
10•ubutler•1w ago•0 comments

Show HN: A CSS-Only Terrain Generator

https://terra.layoutit.com
357•rofko•1d ago•82 comments

Show HN: SSH terminal multiplayer written in Golang

https://github.com/MShel/sshOuroboros
2•mishk0sh•8h ago•0 comments

Show HN: A living wall of life goals and deathbed regrets

https://beforewedie.org
14•jamespetercook•19h ago•9 comments

Show HN: Dynamic Code Execution with MCP: A More Efficient Approach

https://github.com/pranftw/aiter-app
2•pranftw•9h ago•0 comments

Show HN: a Rust ray tracer that runs on any GPU – even in the browser

https://github.com/tchauffi/rust-rasterizer
93•tchauffi•2d ago•29 comments

Show HN: Kumi – a portable, declarative, functional core for business logic

https://kumi-play-web.fly.dev/?example=monte-carlo-simulation
4•goldenCeasar•15h ago•0 comments

Show HN: sudocode – manage specs, tasks, and context-as-code for coding agents

https://github.com/sudocode-ai/sudocode
15•alexsngai•16h ago•5 comments

Show HN: Zee – AI that interviews everyone so you only meet the best

https://www.zeeda.com/
4•davecarruthers•16h ago•4 comments

Show HN: Tamagotchi P1 for FPGAs

https://github.com/agg23/fpga-tamagotchi
68•agg23•1w ago•11 comments

Show HN: SixSevenStudio – open-source Video Editor For Sora

https://github.com/palmier-io/sixsevenstudio
2•hchtin•17h ago•0 comments

Show HN: MyTimers.app offline-first PWA with no build step and zero dependencies

https://mytimers.app/
46•y3k•2d ago•28 comments

Show HN: Strange Attractors

https://blog.shashanktomar.com/posts/strange-attractors
793•shashanktomar•5d ago•77 comments

Show HN: Cj–tiny no-deps JIT in C for x86-64 and ARM64

https://github.com/hellerve-pl-experiments/cj
3•hellerve•18h ago•0 comments

Show HN: Dev Cockpit (OSS) – TUI System Monitor for Apple Silicon

https://devcockpit.app
3•caioricciuti•19h ago•1 comments

Show HN: JermCAD – A YAML-powered, vibe-coded, browser-based CAD software

https://github.com/jeremyaboyd/jerm-cad
3•jermaustin1•20h ago•0 comments

Show HN: I was in a boring meeting so I made an encyclopedia

https://encyclopedai.stavros.io
4•stavros•20h ago•9 comments

Show HN: Wosp – advanced full-text search on the command line

https://github.com/atrettel/wosp
6•atrettel•20h ago•0 comments

Show HN: FinBodhi – Local-first, double-entry app/PWA for your financial journey

https://finbodhi.com/
40•ciju•2d ago•21 comments

Show HN: DMARC report parser as a single Go binary (SQLite, no Elasticsearch)

https://github.com/meysam81/parse-dmarc
2•meysamazad•21h ago•0 comments

Show HN: Free Quantum-Resistant Timestamping API (Dual-Signature and Bitcoin)

5•sasasavic•1d ago•1 comments

Show HN: I built a local-first daily planner for iOS

https://apps.apple.com/ca/app/to-do-list-planner-zesfy/id6479947874
86•zesfy•1d ago•77 comments

Show HN: Pipelex – Declarative language for repeatable AI workflows

https://github.com/Pipelex/pipelex
122•lchoquel•1w ago•27 comments

Show HN: I got fired so I built a bank statement converter

https://aussiebankstatements.com
15•matherslabs•1d ago•3 comments