{"repo":"vgmakeev/katana","free":true,"listed":false,"github":"https://github.com/vgmakeev/katana","clone":"git clone https://github.com/vgmakeev/katana.git","description":"Source-free architecture maps and deterministic polyglot refactoring for AI coding agents","language":"Python","stars":10,"topics":["ai-agents","ast","code-intelligence","developer-tools","refactoring","cli","coding-agents","llm","markdown","python"],"license":"Apache-2.0","category":"ai-agents","readme_excerpt":"Katana Give the agent structure. Let Katana move the code. Deterministic, polyglot refactoring infrastructure for coding agents. Katana lets an AI agent redesign a large file without loading the whole file into its context. It turns source into a compact architecture map, accepts an explicit split plan, moves the selected source ranges byte-for-byte, and then runs the project's own formatter, linter, and typechecker. The agent owns architecture. Katana owns mechanics. Why Katana? Coding agents are good at architectural reasoning and bad at mechanically copying thousands of tokens between files. Reading the entire source also wastes context before the agent has decided what it needs. Katana changes that boundary: - Small context: the agent receives LOC, signatures, relationships, constraints, and exact spans—not source bodies. - Deterministic edits: source ranges are moved byte-for-byte; Katana does not ask an LLM to reproduce code. - Fail-closed adapters: unsupported semantics become visible limitations, never optimistic rewrite claims. - Native verification: Katana invokes tools already configured by the project, such as Ruff, ESLint, Prettier, tsc , mypy, and dart format . - Agent-native protocol: commands are non-interactive, JSON is versioned, and every mutation has a dry-run. - Tiny core: Python 3.14, zero mandatory runtime dependencies. Run with uvx No installation is required: For a reproducible agent environment, pin a release tag or commit: For a persistent installat","default_branch":null,"files":null,"tree":[],"storefront":"/r/vgmakeev","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/vgmakeev/katana/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}