Metadata-Version: 2.4
Name: oadson
Version: 1.0.3
Summary: OADSON Terminal — AI coding agent for your local shell
Author-email: Goodness Olayinka <goodnessolayinka2@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/goodnessolayinka/Oadson_v2
Project-URL: Repository, https://github.com/goodnessolayinka/Oadson_v2
Keywords: ai,cli,coding-agent,terminal,oadson
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: rich>=13
Requires-Dist: typer>=0.12
Requires-Dist: prompt_toolkit>=3.0

# oadson

**OADSON Terminal** — AI coding agent for your local shell.

Powered by your Railway OADSON V2 backend.

---

## Install

```bash
pip install oadson
```

## Setup

```bash
oadson setup
```

Enter your Railway backend URL and API token when prompted.

---

## Usage

### One-shot
```bash
oadson "fix the import error in main.py"
oadson "write a README for this project"
```

### Interactive REPL
```bash
oadson
```

### Pipe mode
```bash
cat error.log | oadson
cat file.py | oadson "refactor this"
python main.py 2>&1 | oadson "what's wrong"
```

### Session management
```bash
oadson session new "auth refactor"
oadson session list
oadson session use 2
oadson session delete 1
```

---

## REPL commands

| Command | Description |
|---------|-------------|
| `/new [name]` | Start fresh session |
| `/sessions` | List all sessions |
| `/delete N` | Delete session #N |
| `/clear` | Clear screen |
| `/help` | Show help |
| `/exit` | Quit |

---

## Permission system

OADSON always shows what it's about to do before doing it.

| Action | Behaviour |
|--------|-----------|
| Read files, git status, ls | Auto — no prompt |
| Write/create files | Shows diff → asks y/n |
| Delete files | Auto-backup → asks y/n |
| Run bash commands | Shows command → asks y/n |
| Destructive patterns (`rm -rf /`) | Blocked always |

Customize permissions in `~/.oadson/config.json`.

---

## Config location

```
~/.oadson/
  config.json    ← backend URL, token, permissions
  sessions.json  ← session history
  history        ← REPL input history
  backups/       ← auto-backups before delete/overwrite
```
