✨ v1.0.0 — Open Source

🐑 Wool

Ultra-lightweight CLI AI Agent. Your terminal is the IDE. Wool is the brain.

$ curl -fsSL https://universeking4.github.io/Wool/install.sh | bash

Works on all Linux distros & Android Termux · View on GitHub →

wool — bash
✓ Connected to 'exa' — 2 tools available. ✓ Connected to 'firecrawl' — 26 tools available. 🐑 Wool v1.0.0 Ultra-lightweight CLI AI Agent Provider: openrouter │ Model: gemini-2.5-pro │ Session: default Tools: 8 built-in │ MCP: 2 servers (28 tools) Type /help for commands 1 wool › explain this codebase and create a test suite ⠹ thinking...

Features

Everything you need in a CLI agent. Nothing you don't.

🔌

Multi-Provider

Works with any OpenAI-compatible API — OpenAI, Anthropic, Google, Groq, Mistral, OpenRouter, Ollama, LM Studio, and more. Hot-swap anytime.

🛠️

8 Built-in Tools

Bash execution, file I/O, code intelligence, web search, URL fetching, parallel subagent delegation, and concurrent multi-tool usage. All toggleable dynamically via the /tools interactive TUI menu.

🔗

MCP Protocol

Connect to any MCP server — stdio, HTTP/SSE, or Streamable HTTP. Boots all connections in parallel for ultra-fast startup. Includes the /mcps interactive TUI menu for live-toggling servers on/off dynamically.

🎛️

Interactive TUI Menus

Wool features 7+ blazing fast interactive menus: /tools, /mcps, /providers, /models, /sessions, /rewind, and /settings. Navigate with keyboard arrows to toggle features on the fly without restarting.

💬

Session Management

Multiple named sessions, interactive TUI browser (/sessions), fork conversations (/fork), rewind history interactively (/rewind), rename, and AI-powered compaction.

⚡

Real-time Streaming

Token-by-token streaming with live markdown rendering, reasoning/thinking display, and a smooth animated spinner.

🎯

Goal Mode

Set a goal using /goal <task> and let Wool work autonomously across multiple turns until the task is fully complete. Hands-free automation.

🧠

Parallel Subagents

Delegate multiple tasks to independent sub-agents that run concurrently in the background. Results are collected automatically.

🛡️

Secure Restrictions

Strict path validations and heuristics confine the agent perfectly to your working directory. Toggleable via the /settings interactive TUI menu.

📱

Cross-Platform

Native support for all Linux distros and Android Termux. Dynamic path resolution, native clipboard integration, zero hardcoded paths.

🪶

Ultra-Lightweight & Robust

Pure Python with a zero-lag event loop. Features atomic state saves, dual-mode commands (e.g. /mcps), graceful tool degradation, and bulletproof memory management.

🛑

Safe Cancellation

Hit Escape (or Ctrl+C) to gracefully cancel active tool executions or LLM generation. Unhandled interrupts perfectly terminate all background child processes without leaking orphans.

🧹

Auto Cleanup

Wool keeps your workspace completely clean. Ghost sessions with no messages are perfectly scrubbed away without leaving a trace.

Built-in Tools

Powerful capabilities the AI can use autonomously.

⚙️
execute_bash
Run shell commands with timeout, safety guards & process group isolation
📖
fs_read
Read files with line ranges, list directories, grep search, image info
✏️
fs_write
Create, replace, insert, or append file content with surgical precision
🔍
code_intelligence
Symbol search, lookup definitions, codebase maps, and pattern search
🌐
web_fetch
Fetch and extract readable content from any URL on the web
🔎
web_search
Search the live web via DuckDuckGo and return structured results
🧩
use_subagent
Delegate tasks to parallel sub-agents for concurrent background execution
🚀
multi_tool_use
Execute multiple tools concurrently in a single step to bypass limitations

Commands

All slash commands available inside the Wool REPL.

wool -u, --update, --upgradeUpdate Wool to the latest version
wool -e, --exportExport config and sessions to ./wool-export
wool -i, --importImport config and sessions from ./wool-export
wool --uninstallCompletely remove Wool, including sessions & config
wool -c, -r, --continue, --resumeResume the last session instead of starting fresh
/helpShow this help message
/provider [list|add|remove|switch]View or manage AI providers
/providers [args...]Open interactive provider menu (or pass args)
/model [list|switch <id>]View or change the active model
/models [args...]Open interactive model menu (or pass args)
/session [list|new]Manage sessions
/sessions [args...]Open interactive session menu (or pass args)
/newCreate and switch to a new session
/renameRename the current session
/forkFork current conversation to a new session
/resume, /continueResume the last previous session
/rewindInteractively rewind history to a specific message
/toolsOpen interactive menu to manage and toggle tools
/mcp [list|connect|disconnect]Manage MCP servers
/mcps [args...]Open interactive MCP menu (or pass args)
/goalSet a goal and work autonomously until complete
/usageView token usage for the current session
/contextView detailed token breakdown of current context
/clearClear conversation history
/compactCompact history (keep system + last 4 turns)
/statusShow current session status
/copyCopy the last AI response to clipboard
/settingsOpen interactive settings menu
/exit, /quitExit Wool

Get Started

One command. That's all it takes.

$ curl -fsSL https://universeking4.github.io/Wool/install.sh | bash

The installer automatically handles everything — Python, Git, pip, PATH configuration.

Or install manually: pip install git+https://github.com/UniverseKing4/Wool.git