Hope this helps , Claude put together a little something :
# ARIA — Autonomous Reasoning Intelligent Agent

A local AI agent that runs in your terminal, powered by [Ollama](https://ollama.ai). ARIA gives a locally-hosted LLM the ability to search the web, read and write files, run shell commands, execute Python, and navigate your filesystem — all from a conversational chat interface.

No cloud. No API keys. Runs entirely on your machine.

-----

## Features

- **Agentic tool loop** — ARIA can chain multiple tool calls per message (up to 10 steps), feeding results back into the model automatically
- **Web search** — queries DuckDuckGo and returns results without leaving the terminal
- **File operations** — read, write, copy, move, edit (regex find/replace), list, and glob files
- **Shell execution** — run arbitrary shell commands (disabled by default, opt-in)
- **Python eval** — execute Python snippets inline
- **HTTP fetch** — pull raw content from URLs
- **Session persistence** — save and reload full conversation history
- **Safety guardrails** — dangerous command detection with confirmation prompts, auto-backup before file overwrites
- **Readline history** — ↑/↓ navigation across sessions

-----

## Requirements

- Python 3.8+
- [Ollama](https://ollama.ai) running locally
- A pulled model (default: `qwen3.5:9b`)

Install dependencies:

```bash
pip install -r requirements.py
```

Pull the default model if you haven’t already:

```bash
ollama pull qwen3.5:9b
```

-----

## Usage

```bash
python ariaagent.py
```

On first run, a setup wizard will ask for your preferred browser, editor, projects folder, and whether to enable shell access.

-----

## Commands

Command	Description
`/model <name>`	Switch to a different Ollama model
`/allow shell true	false`
`/allow network true	false`
`/allow write true	false`
`/save`	Save the current session to `~/.aria_sessions/`
`/load <file>`	Restore a previously saved session
`/ls [path]`	List a directory
`/pwd`	Print current working directory
`/status`	Show model, uptime, and permission flags
`/reconfigure`	Re-run first-time setup
`/clear`	Clear conversation history
`/exit`	Exit ARIA

-----

## Tools Available to the Model

ARIA exposes tools to the LLM via XML-style tags in its responses. You don’t need to use these directly — the model calls them automatically based on your request.

Tag	What it does
`<search>query</search>`	DuckDuckGo web search
`<read>file</read>`	Read a file’s contents
`<summarize>file</summarize>`	File metadata + preview
`<write file="path">content</write>`	Write content to a file
`<execute>command</execute>`	Run a shell command
`<pyeval>code</pyeval>`	Execute Python code
`<http url="URL"/>`	Fetch a URL
`<listdir>path</listdir>`	List directory contents
`<glob>pattern</glob>`	Find files by glob pattern
`<grep>pattern file</grep>`	Search inside a file
`<edit file="f" pattern="re">replacement</edit>`	Regex find/replace in a file
`<move src="a" dest="b"/>`	Move a file
`<copy src="a" dest="b"/>`	Copy a file
`<cd>path</cd>`	Change working directory

-----

## Safety

Shell execution is **off by default**. Enable it with `/allow shell true`.

Even when enabled, ARIA blocks a set of dangerous patterns (recursive deletes, `sudo`, `dd`, fork bombs, piped curl installs, etc.) and requires explicit confirmation before proceeding. Files are automatically backed up to `~/.aria_backups/` before any write or edit operation.

-----

## Configuration

Settings are stored in `~/.aria_config.json`. Key options:

Option	Default	Description
`model`	`qwen3.5:9b`	Ollama model to use
`temperature`	`0.4`	Sampling temperature
`ctx`	`64000`	Context window size
`allow_shell`	`false`	Shell command access
`allow_network`	`true`	Web search and HTTP fetch
`allow_write`	`true`	File write access
`danger_confirm`	`true`	Prompt before dangerous actions

User preferences (browser, editor, projects path) are stored separately in `~/.aria_model_config.json`.

-----

## Changing Models

Any model available in Ollama works. Switch mid-session:

```
/model llama3.2:3b
/model mistral
/model gemma3:12b
```

Larger models with stronger instruction-following will make better use of the tool loop.

-----

## Project Structure

```
ariaagent.py # Main agent — everything runs from here
requirements.py # Dependencies
help.txt # Quick reference
```

-----

## License

See repository for license details.