Metadata-Version: 2.4
Name: exorous
Version: 0.1.0
Summary: A professional AI coding agent that can execute tasks using tools and manage complex development workflows.
Author: Riazul Islam
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openai>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: click>=8.0.0
Requires-Dist: tomli>=2.0.0
Requires-Dist: platformdirs>=4.0.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: duckduckgo-search>=6.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: tiktoken>=0.5.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: eval_type_backport
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: tomli-w>=1.0.0
Dynamic: license-file

# Exorous Code

A professional AI coding agent that can execute tasks using tools and manage complex development workflows.

## Installation

Install directly from the source:

```bash
pip install .
```

Or if you are developing:

```bash
pip install -e .
```

## Usage

Start the interactive coding agent:

```bash
exorous
```

On the first run, Exorous will prompt you to:
1. Select your preferred LLM provider (OpenRouter, OpenAI, Anthropic, or Gemini).
2. Enter your API key for the selected provider.

Alternatively, run a single prompt:

```bash
exorous "Refactor the main.py file"
```
- Multi-turn conversations with tool calling
- Configurable model settings and temperature

### Built-in Tools

- File operations: read, write, edit files
- Directory operations: list directories, search with glob patterns
- Text search: grep for pattern matching
- Shell execution: run shell commands
- Web access: search and fetch web content
- Memory: store and retrieve information
- Todo: manage task lists

### Context Management

- Automatic context compression when approaching token limits
- Tool output pruning to manage context size
- Token usage tracking

### Safety and Approval

- Multiple approval policies: on-request, auto, never, yolo
- Dangerous command detection and blocking
- Path-based safety checks
- User confirmation prompts for mutating operations

### Session Management

- Save and resume sessions
- Create checkpoints
- Persistent session storage

### MCP Integration

- Connect to Model Context Protocol servers
- Use tools from MCP servers
- Support for stdio and HTTP/SSE transports

### Subagents

- Specialized subagents for specific tasks
- Built-in subagents: codebase investigator, code reviewer
- Configurable subagent definitions with custom tools and limits

### Loop Detection

- Detects repeating actions
- Prevents infinite loops in agent execution

### Hooks System

- Execute scripts before/after agent runs
- Execute scripts before/after tool calls
- Error handling hooks
- Custom commands and scripts

### Configuration

- Configurable working directory
- Tool allowlisting
- Developer and user instructions
- Shell environment policies
- MCP server configuration

### User Interface

- Terminal UI with formatted output
- Command interface: /help, /config, /tools, /mcp, /stats, /save, /resume, /checkpoint, /restore
- Real-time tool call visualization
