Refactory

Hybrid code decomposition. AI plans the boundaries. A deterministic engine handles the routine extractions. Minimize tokens, maximize syntax validity.

Refactory splits monolith source files into clean modules. It uses an LLM for one thing — deciding which functions group together. Everything else is mechanical: function boundary detection, import resolution, module assembly, syntax validation, scoring.

JavaScript and Python extraction is mostly mechanical.The deterministic engine handles the straightforward moves — the routine 80% that's a waste of AI time and tokens. The LLM still handles complex edge cases where judgment matters. Other languages use LLM extraction with adaptive compression.

Works with Claude Code, Cursor, Windsurf, VS Code Copilot — any MCP client. Or use the CLI directly.

{ "mcpServers": { "refactory": { "command": "npx", "args": ["@refactory/mcp"], "env": { "GROQ_API_KEY": "your-key-here" } } } }

Then tell your AI tool:"Analyze and decompose src/big-file.js into modules"

One free API key (Groq or Gemini) is needed for the PLAN step only. Extraction is mechanical — no key required for JS/Python.

git clone https://github.com/codedrop-codes/refactory.git cd refactory && npm install node src/cli.js decompose src/big-file.js

refactory analyze src/big-file.js # Health check + function map refactory plan src/big-file.js # Generate module boundaries (needs LLM key) refactory verify lib/modules/ # Check extracted modules refactory languages # Show supported languages refactory providers # Show configured LLM providers refactory test submit broken.js # Submit a file that breaks extraction refactory test run # Validate preprocessors against test corpus

1. ANALYZE Scan functions, dependencies, health — mechanical | 2. CHARACTERIZE Snapshot exports before touching anything — mechanical | 3. PLAN LLM decides module boundaries — the only AI step | 4. EXTRACT Copy functions by line range, resolve imports — mechanical | (LLM fallback for unsupported languages) 5. FIX-IMPORTS Rewrite require()/import paths — mechanical | 6. VERIFY Syntax check, load check, export comparison — mechanical | 7. METRICS Refactory Score + HTML report — mechanical

6 of 7 steps are deterministic. The LLM only decideswhereto split — it never touches your code.

Mechanical extraction handles the routine cases: the preprocessor finds function boundaries by parsing, copies them by line range, and resolves imports deterministically. Complex patterns (dynamic exports, deeply interleaved logic) still go through the LLM.

Contribute a preprocessorfor your language.

refactory test submit broken-file.js -d "what went wrong"

- Discord— Help, ideas, show your results
- Discussions— Feature requests, language requests
- Issues— Bug reports
- Contributing— Build a preprocessor, submit test files

Premium language packs available under commercial license. Seerefactory.codedrop.codes.

Skene is a codebase analysis toolkit for product-led growth. It scan your codebase, detect growth opportunities, and generate actionable implementation plans.