villacode

Villa AI — an AI code reviewer in your terminal.

Ask it, in plain language, to review a file, several files, your whole project, or your git changes. It finds real bugs, security issues, and risky patterns, and shows fix suggestions inline.

Install

npm install -g villacode

Quick start

villacode

That launches the interactive assistant. Then just talk to it:

❯ review src/auth.ts
❯ check src/a.ts, src/b.ts
❯ review the whole project
❯ review my changed files
❯ pick a file
❯ summary

Logging in

Use your Villa AI account (reviews run on the platform, model managed for you):

villacode login

…or inside the chat: /login.

Bring your own key (BYOK)

Prefer your own provider? Log out and point it at OpenRouter / OpenAI / Anthropic with your own key and model:

/logout
/provider openrouter
/key sk-or-...
/models deepseek        # pick a model from the list

BYOK calls your provider directly — no platform account or credits needed.

Commands (inside the chat)

| Command | What it does | |---|---| | /login /logout /whoami | account auth | | /config | show settings (secrets masked) | | /url <url> | point at a different API | | /apikey <key> | use a backend API key instead of login | | /provider <name> | set BYOK provider (openrouter | openai | anthropic) | | /models [search] | pick a model from your provider | | /model <slug> | set a model directly | | /key <key> | set your BYOK provider key | | /clear /exit | clear screen / quit |

One-shot (non-interactive)

villacode validate src/auth.ts
villacode project ./src

Config

Settings live in ~/.ai-validator/config.json (chmod 600). Inspect or change them:

villacode config --list
villacode config --set apiUrl=https://your-api.example.com

License

MIT