oblivion-agent 2.9.0

OBLIVION - Terminal AI coding agent with voice, RAG, and multi-model support. Powered by Meera.

OBLIVION

Terminal AI coding agent with voice, RAG, and multi-model support. Powered by Meera.

Install

pip install oblivion-agent

With voice:

pip install "oblivion-agent[voice]"

First Run

oblivion

A setup wizard will ask for your LLM provider (Gemini recommended, free).

Features

• Voice in (Whisper) and out (Edge TTS / ElevenLabs)
• 9 LLM backends with auto-fallback (Gemini, Groq, Claude, GPT-4o, DeepSeek, Ollama, Cerebras)
• Hybrid code search: exact symbol + full-text + semantic embeddings
• 22 tools: filesystem, bash, symbol navigation, code verification, project memory
• Built-in knowledge packs (React, Django, FastAPI, Docker, security, more)
• Cyberpunk TUI with slash commands, file watcher, status bar
• Workspace memory persists across sessions (MEMORY.md per project)

Slash Commands

• /help - all commands
• /model - switch LLM
• /voice - voice settings
• /meera on|off|test - toggle voice replies
• /index - reindex workspace
• /openproject - switch project
• /newproject - create project
• /memory - view workspace memory
• /stats - session info

Config

Lives at ~/.oblivion/config.env

Claude Desktop Integration (MCP)

Oblivion ships an MCP server. Claude Desktop can use Oblivions 10 read-only code tools directly.

Setup

1. Install Oblivion: pip install oblivion-agent

2. Find your Claude Desktop config file: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

3. Add this JSON to it:

   { "mcpServers": { "oblivion": { "command": "oblivion", "args": ["mcp"], "env": { "WORKSPACE_DIR": "/path/to/your/project" } } } }

4. Restart Claude Desktop. Done!

Exposed tools (read-only)

read_file, list_dir, grep_files, file_exists, search_code, find_symbol, list_symbols, find_callers, project_map, recall

Write tools are NOT exposed for safety. Use the Oblivion TUI for edits.

Testing

npx -y @modelcontextprotocol/inspector oblivion mcp

License

MIT