Metadata-Version: 2.5
Name: uncoded
Version: 3.0.1
Summary: Symbol index with associated code reading tools for AI coding agent navigation
Project-URL: Homepage, https://github.com/alimanfoo/uncoded
Project-URL: Repository, https://github.com/alimanfoo/uncoded
Author-email: Alistair Miles <alimanfoo@googlemail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.12
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# uncoded

AI coding agents navigate codebases poorly. They grep for guessed keywords, skim
the first few lines of files, and fill gaps from pretraining rather than reading
the actual code. The result is plausible-looking output built on a hallucinated
understanding of the code.

**uncoded** builds a static navigation index that gives coding agents
progressively deeper views of a codebase. Agents start with the namespace map,
read compact stubs when they need parameters and types, and retrieve only the
symbol bodies that they need. Each view adds detail without making the agent
read whole source files.

The `uncoded body` command retrieves symbol bodies, and `uncoded refs` finds
every reference to a symbol. References cover callers, dead-symbol checks, and
the full set of sites to update before a rename.

Read the [documentation](https://alimanfoo.github.io/uncoded/) for installation,
configuration, command reference, upgrades, and contributor guidance.
