Violytra

A free AI agent for your terminal — OpenCode-style interface, powered by the keyless OpenFree API. It can read files, run shell commands and control your PC, but every action asks for your approval first.

npx violytra

or from this repo:

node cli/violytra.mjs

Usage

violytra                    # interactive session
violytra "clean my temp folder and show disk usage"

| Flag | Meaning | | --- | --- | | -m, --model <id> | pick a model (/models lists them) | | --yolo | auto-approve every tool call (dangerous) | | --safe | read-only: no shell, no writes | | --api <url> | point at another OpenFree-compatible endpoint |

Slash commands

/help /models /model <id> /mode <ask\|yolo\|safe> /cwd <dir> /web <on\|off\|auto> /clear /exit

PC control

Tools available to the model: run_shell, read_file, write_file, list_dir, sysinfo. In the default ask mode reads are automatic and anything that changes your machine prompts allow? [y]es / [n]o / [a]lways. --safe disables shell and writes entirely.

No API key, no account. Works on Windows, macOS and Linux with Node 18+.