The changelog

Releases

A project in motion. Every npm release, and what it brings to your map.

Dates are npm publication dates. Features on main that have not shipped yet appear in the docs as “Next release”.

v0.5.0Latest release

One column. A guided way into your code.

A simpler map layout, a tour of your own repository and more reliable agent connections.

Added

  • A first-visit tour follows a file through the map, search, code, flows, dependencies and history in your own repository. Optional chapters introduce agents, explanations, people, pull requests, features and settings.
  • Setup connects agents to their MCP server and installs activity hooks for this repository, so their work appears in Agents. Local hook settings stay out of Git; Codex asks you to trust new hooks in /hooks.
  • The Explain view identifies agents using another Codiluce version and offers the setup command that reconnects them to the map’s version.

Improved

  • A rail on the left opens one shared, resizable column for selection, code, impact, flows, dependencies, people, pull requests, explanations and agents. Selecting code keeps the current view open; Color by lives on the map.
  • Dependencies follow the selection while their view is open, and Impact keeps its results when you change views.
  • Agent setup pins npx commands to the running Codiluce version. Activity hooks start the cached package directly, falling back to npx if the cache was cleared.

Fixed

  • Agent connection detection and recovery handle servers bound to another repository or installation, and failed connection and session checks offer a retry.
  • Older MCP servers can still show explanation progress when they report an explicit explanation title or question.
  • Updated the bundled map’s build dependency to the patched Next.js 16.4.6 release and clarified the composer’s missing API key message.
v0.4.0

Follow your agents. Explore every connection.

Agent characters and session replays, guided explanations, a 2D plan and dependency maps bring the code into focus.

Added

  • Agent characters move between the files they read and edit, split for parallel work and wait in a queue while thinking or running commands. Browse saved sessions and replay them step by step with playback controls.
  • Explanation tours tell a story in scenes on the map, with diagrams tied to indexed code. Search reusable question templates, fill their placeholders and ask in the map or through your agent.
  • Switch between the 3D map and a 2D plan with labels that avoid overlaps. Select code to follow its dependencies and inspect the evidence behind each connection.
  • Shared adapters for twelve coding harnesses, with MCP, activity and session-history capabilities depending on the harness. Experimental adapters and their limits are documented in the agent guide.
  • Browse each file’s Git evolution, with architecture snapshots available on demand.

Improved

  • Setup loads the complete Git history in the background without asking for a depth. The map opens with calmer defaults, and analysis follows more Node HTTP routers, fetch wrappers and object methods.
  • Further bounded parser and history processing, with compatibility and performance qualification across the supported language and framework packs.
v0.3.0

See your agents at work.

Live agent activity, explanations as they are written, pull requests and code health arrive on the map.

Added

  • Follow live Claude Code and Codex sessions through activity hooks: see which files an agent reads, edits or searches while it works.
  • An explanation working card shows what an agent is explaining and the tools it calls before its answer is published.
  • Open and merged pull requests light up the files they change, with their commits and impact.
  • Code health metrics in the Inspector and Color by lenses for complexity, recent changes and hotspots.

Improved

  • Continuous flow playback, clearer flow controls, refined map shapes and area summaries, and saved map visibility settings.
  • Bounded parser and compiler transfers, memory limits and worker recovery make large analyses and Git histories more resilient.
v0.2.0

Ask your agent. Read the answer on the map.

MCP explanations, first-run setup and a much wider set of languages and frameworks.

Added

  • Connect coding agents over MCP to read the indexed graph and publish explanations. Their links highlight the files, symbols and flows they describe in the Explain column.
  • Ask questions directly in the map with your own API key. A first-run setup guides history indexing, optional model keys and agent connections.
  • Framework analysis expands to Python, Vue, Svelte, Astro, Nuxt, Go, Ruby and Rails, Java and Kotlin with Spring, C# with ASP.NET, and Rust. Each pack records its evidence and limits.
  • Source structure for additional languages and embedded templates, including C, C++, Objective-C, Swift, Scala, Groovy, F#, VB.NET, ERB, Razor and Liquid.

Improved

  • Branching request flows play on the map. Parser workers, caching and historical snapshots have tighter memory and lifetime bounds, with published compatibility evidence.

Fixed

  • Fixed the Flows panel repeatedly reloading when its view identity did not match the active map grouping.
v0.1.1

A home for the project.

Package links now point to codiluce.com and the Codiluce GitHub organization.

Updated

  • Corrected the npm homepage, repository and issue tracker links. This packaging update keeps the same CLI and map bundles as 0.1.0.
v0.1.0

Bring your code to light.

The first usable npm release: a local, interactive map of your repository and its history.

Added

  • Start with npx codiluce@latest start .: the package includes the compiled CLI and prebuilt map, with no target application build required.
  • An evidenced graph for Next.js and Laravel, with TypeScript and JavaScript analysis, frontend-to-backend request flows and database tables.
  • A zoomable isometric map with search, an evidence inspector, source code, flow playback and themes.
  • Git history snapshots, architectural and source diffs, authorship and blast radius, plus optional model-generated descriptions and feature grouping.
v0.0.0-stagePre-release

Preparing the first release.

A temporary npm placeholder used to set up publishing before the first usable release.