Codemble

Stable v0.22.0Nine languages · PyPI published

Explore the code AI left behind.

Codemble reads a project on your machine and turns its real structure into a galaxy you can explore or a diagram you can follow. Study real source, trace parser-proven routes as far as the evidence goes, see what a change reaches, and light only what you prove you understand.

Download CodembleRun in one command
uvx --from codemble==0.22.0 codemble

The screen, one-command route, and downloads are all v0.22.0. PyPI publishes the package; GitHub mirrors the exact artifacts and checksum ledger.

Codemble v0.22.0 showing 217 visible, colourful systems across Python, JavaScript, TypeScript, Go, Java, Rust, C#, Ruby, and PHP in a luminous spiral galaxy, with parser-proven routes, ranked labels, 37 charted systems, eight unreadable fixtures, and Home resolved to codemble.cli without amber understanding light.
Current app · luminous Explore galaxy217 systems · nine languages · local only

Everything pictured ships in v0.22.0. Run it in one command, download the verified release artifacts, or build the same release from source.

Choose a route →

See the whole project. Then follow one fact.

These are not mockups. Each frame is a fresh capture of this repository running through the current Codemble source, with the same Home and the same parser-owned graph.

  1. Codemble v0.22.0 galaxy with 217 visible, colourful systems across nine languages, a luminous spiral starfield, parser-proven route corridors, ranked labels, 37 charted systems, and Home resolved to codemble.cli without amber understanding light.
    Current app · Explore

    01 · Explore

    Begin with a sky that is already readable.

    All 217 systems are visible and colourful on the first frame inside a luminous deterministic sky. Free exploration keeps the whole project alive; a guided First Flight may quiet distant context while it teaches one parser-owned route.

  2. Codemble’s Expert canvas Architecture map showing Home, connected server modules, real lines of code, and complete bottom rows for modules with no proven import route.
    Current app · Map

    02 · Map

    Flatten the same evidence into a reading path.

    Architecture lays modules out by proven imports from Home. Workflow follows certain calls from the entrypoint. Modules with no proven route remain in complete bottom rows rather than being guessed into the graph.

  3. Codemble’s codemble.cli solar system with a luminous Python module Sun, four named worlds in labelled call orbits, and five nearby import routes whose certainty remains visible.
    Current app · Land

    03 · Land

    Enter a solar system with a real Sun.

    The module anchor becomes the system's Sun. Named functions and classes become language-styled worlds in parser-owned call placement, while the nearby-systems console continues along certain and possible imports without merging them. Land on any world for Easy or Expert evidence.

  4. Codemble Expert study panel for the server app module, scrolled to integrated Impact over the Architecture map.
    Current app · Inspect

    04 · Inspect

    Follow the feature route before a model speaks.

    Study follows parser-owned evidence only as far as it reaches from Home toward the selected feature. A visible proof break stops the journey before any separate possible frontier. Easy guides a cited step; Expert keeps that step and adds its parser rule, while selected-feature impact, connections, and test candidates stay clearly scoped.

  5. Codemble’s Home system after its checks were passed: all four parser-proven structures glow amber, Review understanding is available, and the next route points to codemble.adapters.project.
    Current app · Prove

    05 · Prove

    Earn the one colour that means understanding.

    Short checks come from the graph, never the narrator. Pass Home and its four parser-proven structures glow amber; the next useful route advances while charted systems remain a separate record of where you have been.

Choose the route that fits today.

Run without installing, download the exact wheel, or keep an editable source checkout. All three routes lead to v0.22.0.

Recommended

Run Codemble v0.22.0

Best for a first real project. It is the latest GitHub release and PyPI package, with the exact wheel, source archive, and SHA256SUMS ledger mirrored on GitHub.

  1. 01
    Install uv oncebrew install uv
  2. 02
    Open Codembleuvx --from codemble==0.22.0 codemble
Download wheelSource archiveSHA256 digestsRelease notes

What Codemble does, without the astronomy lesson.

Point it at a folder. Codemble reads supported source without running your app, package scripts, compilers, or tests.

Choose your launch
Start in a luminous, fully visible galaxy or take a bounded First Flight from Home. Explore keeps every system colourful; Learning can quiet distant context while guiding one honest route.
Enter a living solar system
The module anchor is its Sun. Named functions and classes become language-styled worlds in call orbits that keep direct calls and call roots distinct, while a nearby-systems console follows parser-owned inbound and outbound imports with certainty intact.
Know what a change touches
Impact traces what depends on a structure and what it depends on, with real file locations and certainty labels—no model required.
Prove what you understand
Graph-derived checks are the only way to light a system amber. Visiting and understanding remain two different claims.
Keep the project local
Parsing, maps, feature journeys, source, Impact, checks, and progress stay on your machine. Optional narration goes only to the provider you configure.
Read nine languages together
Python, JavaScript, TypeScript, Go, Java, Rust, C#, Ruby, and PHP share one honest graph contract, including mixed projects.
One project can mix:PythonJavaScriptTypeScriptGoJavaRustC#RubyPHP

The map admits where certainty ends.

Codemble is for readers who may not yet spot a confident mistake. Accuracy therefore outranks visual drama, feature count, and model fluency.

  1. 01

    Nodes, routes, concepts, Home candidates, and application roles come from parsers—not generated prose.

  2. 02

    A feature journey stops where proof stops, before showing a visibly possible frontier.

  3. 03

    Impact and checks are graph-derived and work without any API key.

  4. 04

    Narration may name only supplied identifiers and cite real source lines.

  5. 05

    Changing a file re-dims only the proof attached to that file.

  6. 06

    Unsupported or broken source is counted and named instead of silently omitted.

Before you point it at a repository.

Does Codemble run my code?

No. It reads supported source files and parses their structure. It does not run the project, package scripts, compilers, or tests.

Do I need an Anthropic or OpenAI key?

No. The galaxy, maps, feature journeys, source, structural summary, Impact, Lens, checks, and saved progress all work without a model. If you configure a narrator, opening Study automatically requests grounded prose with bounded context.

Are these screenshots from the downloadable app?

Yes. The captures and published PyPI package report v0.22.0; the current application source preserves that user-facing behavior. Each frame is reproduced from the real local app, not a mockup.

What happens when Codemble cannot prove a relationship?

It ends the proven route at a visible break, then shows only the possible frontier that can still lead toward your selected feature. Broken or unsupported source stays counted instead of vanishing from the picture.