axit / axit.sh

wckd.ai / file search & storage

find it.
axit

Find the file. See what’s taking up space. Review what goes.
A fast, local terminal tool that makes your disk legible.

Get AxitDownloads & checksums →

macOS + Linux · ARM64 + x86-64 · Rust · MIT

Axit's Lichen terminal interface: indexed files, disk usage, inspection and keyboard or mouse actions
The real terminal interface, shown with temporary sample files. Keyboard, mouse and touchpad supported.

a little sharper

Three jobs.
One small binary.

01 / find

The fast part.

Search indexed names, paths, file types, sizes and ages. Live results stay out of the UI thread, so you can keep moving.

02 / understand

Follow the space.

Browse large folders, inspect files and see where access is restricted. Free disk space is reported separately from indexed estimates.

03 / axit

You get the last word.

Review Trash, moves and verified cache cleanup before applying. Undo reversible moves. Automatic cleanup starts off.

ready when you are

Install. Open. Find.

No account. No Rust toolchain for release installs. No background service.

curl -fsSL https://axit.sh/install.sh | sh

Then run axit. The installer checks SHA-256 and installs to ~/.local/bin. It preserves preferences and does not scan or delete user files.

Choose a platform download → · Build from source →

agent friendly

Your tools
can find things, too.

MCP exposes scoped search, browsing and plans. Mutations are disabled by default. The ACP adapter supports deterministic metadata commands without running a language model.

MCP setup → · ACP setup →

axit
axit search 'ext:pdf size:>100mb'
axit browse
axit mcp --root "$HOME"
axit acp --root "$HOME"

before you swing

Clear boundaries.

What does Axit read?

The index stores file metadata and names. It does not index file contents, follow symlinks or scan other mounted filesystems. Access failures are counted and visible in Activity.

What can it clean?

Recognized generated caches with ownership, age, Git, activity and protected-content checks. Whole Rust target directories and release profiles are preserved. Trash and moves use a reviewed plan; permanent cache cleanup is clearly labeled.

Does it run automatically?

Automatic cleanup is off by default. Opt-in rules need explicit folders and apply age, size, free-space and cooldown limits. No background service is installed automatically.

What about macOS privacy permissions?

Grant your terminal Full Disk Access to include protected locations. Administrator access alone does not remove macOS privacy restrictions. Axit reports gaps in coverage.

I used SCRY. Is my index still here?

Yes. Axit reuses the previous private store when no Axit store exists, including the index, preferences and undo journal. Legacy configuration variables and MCP tool names remain accepted.

File mutations require lsof; scans and search work without it. Folder totals can overlap, and indexed sizes need refreshing after changes.