JugaadAgent

Local-first, self-healing Ubuntu terminal agent. Natural language in, bash out — LangGraph state loops, Ollama, risk guardrails, and Ubuntu diagnostics on failure.

Install

Requires Python 3.10+, Linux, and Ollama running locally.

pip install jugaad-agent

Recommended for CLI tools (isolated, no venv juggling):

pipx install jugaad-agent

Pull a model once Ollama is running:

ollama serve          # if not already running
ollama pull qwen2.5-coder:latest

From source (development)

git clone https://github.com/jugaad-agent/jugaad-agent.git
cd jugaad-agent
pip install -e ".[dev]"

Usage

jaa                              # interactive
jaa "create a folder demo and list it"
jaa "free port 8080" --dry-run
jaa "install htop" --yes         # auto-approve risky commands
jaa -m llama3.2:3b "echo hi"     # set + remember default model
jaa "echo hi"                    # reuses last -m choice
python -m jugaad_agent "echo hi"

jugaad is an alias for jaa.

Model selection

Priority: -m / --model (persisted) → JUGAAD_MODEL env (this run only) → saved preference → qwen2.5-coder:latest.

Environment

Copy .agent_rules.md.example to .agent_rules.md in your project directory for workspace-specific preferences.

How it works

memory → generator → guardrail → executor
              ↑            fail + retries

Safety

LOW risk commands run automatically. MEDIUM/HIGH risk opens a [Y]es / [N]o / [E]dit prompt. This tool executes real shell commands on your machine — review every approval.

Publish (maintainers)

pip install build twine
python -m build
twine check dist/*
twine upload dist/*

License

MIT