Early testing

Codemble needs learners who built a small Python, JavaScript, TypeScript, or mixed project with AI and want to understand it better. Success is simple: without maintainer help, light one system and confirm it stays lit after restart.

Install

Install uv once, then run Codemble through it:

brew install uv         # once per machine; or the installer at docs.astral.sh/uv
uvx codemble

Prefer a permanent install? pipx install codemble, then run codemble — no uv needed.

Codemble opens your browser to an in-app picker — pick your project folder there, or pass one directly: codemble ./path-to-your-project.

An API key is optional. Do not read the rest of the docs before the first run; the product should teach the loop itself.

Try the loop

1. Find or choose Home.
2. In a mixed project, focus one language and return to All.
3. Enter a system and open one source structure.
4. Return to the system, choose Prove understanding, and light it.
5. Quit, run the same command, and confirm the system remains lit.

Report the friction

Use the early-tester issue form. Quote your first confusing moment verbatim. Never paste private source, project names, credentials, or API keys. A wrong node, edge, Lens claim, line citation, or check answer is a highest-severity correctness bug.

If you cannot light a system without help, that is valuable product evidence, not user error.