Twitxy Saved

Nick e/code

Verified account This account is verified. Learn more

@nicksdot

Been throwing code into editors for 20+ years. Automating things. PHP contributor. World citizen. Migrant. Annoying. Tweeting for myself.
nicksdot.dev Joined May 2009
317 Following 1.6K Followers 10K Posts

Latest posts 5

Pinned post

Nick e/code Verified account @nicksdot
馃帀 Introducing `refactorlah` CLI -- fully open source.

Agents are surprisingly bad at renaming/moving files.

They are doing `git mv`s, then dozens of `grep`s, then hand-editing imports/namespaces/references while burning tokens and wasting time on tiny refactors.

The `refactorlah` CLI gives them one boring command instead:

`refactorlah move A B` or in bulk `refactorlah move --use-list A,B tests/A,tests/B`

Then file/s are moved, and namespaces, imports, references, etc. automatically updated.

Ambiguous renames are skipped and reported, so the agent can follow up manually instead of guessing.

Support for Go, Python, PHP, Symfony, Twig is landed.
A PR for JavaScript, TypeScript, Vite etc. is open.

I built and dogfooded `refactorlah` over the last few weeks. It works better for me than keeping an MCP server running in an IDE or making agents struggle through long tool-call chains for basic moves.

Still in alpha! Experimental, built with my best buddy Codex, and still dogfooding.

More eyes -> more dogfooding -> releasing early.

What do you think?
7 replies 3 reposts 14 likes 5.3K views View on X
Nick e/code Verified account @nicksdot
Every day adding small improvements makes it hard to say what has the biggest impact on agent quality. But if I would have to name one must have, after being locked in for ~50 days, I'd say it's having `AGENTS.md` in every relevant, nested directory. Each `AGENTS.md` can be as thin as a few lines, has only slice-relevant special instructions and references relevant external knowledge, as well as the `AGENTS.md` files on the next lower level. Tell your agent to keep the indexes fresh with a commit hook.