Aluy v1.0.0-rc.1 · beta · open source · MIT

Your local agent
that works at scale

A local agent that reads and edits your files, runs your commands and takes the task end to end — then scales into a fleet of subagents, running in cycles until it’s done. Your session, data and key stay on your machine. Only the model call crosses the edge.

install — one line
bash — install aluy
$ curl -fsSL https://aluy.dev/install.sh | bash
1 line · no sudo·installs to ~/.aluy·re-run to update

Best experience in WezTerm — the terminal best suited to run the Aluy CLI.

your first minute
$ aluy # opens a session in this project
/doctor ✓ model · key · broker · MCP — all good
/init creates AGENT.md for this repo
/cycle "run the tests and fix what breaks"
working in cycles… stops on green or at the cap ↩
/memory list what aluy remembers here
Read the docs
one agent, at scale

What you'll put it to work on.

Tasks

Bulk renames, file wrangling, reports, data cleanup — describe it, it does it in your shell.

Processes · RPA

Wires steps and tools into one process. End to end, instead of brittle scripts that break.

Testing

Writes, runs and fixes until it passes. Reads the error, corrects it, runs again.

Development

Reads the project, proposes the change, edits files and runs the build. You review and approve.

what it does differently

Not a chat about your code. A team that acts.

/cycle

Kick it off and go do something else

Works in cycles on its own until the task is done — with a handbrake. Hard caps on time and steps, plus automatic stops.

/subagent

A fleet of specialists

Each subagent is a profile (.md) with a focus — one for tests, one for review, one for docs. Delegate and they work in parallel.

/rooms

Watch the fleet collaborate live

Rooms put several agents talking to each other about the problem — debating, splitting the work. You follow in real time and jump in whenever.

/mcp

Plug in what you already use

Through MCP, the agent talks to databases, APIs and services. An open ecosystem of connectors it can actually use — not just chat about.

the model's path

Local where it matters, connected where it needs.

stays on your machine

The session, history, project files, memory and your provider key. The agent runs locally, behind the permission gate.

crosses the edge

Only the model call: through the broker by default, or the provider you connect. In direct mode, it's your credential and your usage.