documentation/api-reference/command-reference.md

# Command Reference

Complete reference of all OPSIIE commands.

## 🧠 Memory Commands

### /recall
**Retrieve relevant memories**
```bash

/recall <keyword>

```
**Examples**: `/recall project x`, `/recall quantum computing`

### /memorize
**Store important information**
```bash

/memorize <message>

```
**Examples**: `/memorize Deadline is Friday`, `/memorize I prefer Python`

### /forget
**Exclude last interaction from memory**
```bash

/forget

```

### /soulsig
**Manage Soul Signature**
```bash

/soulsig                 # View

/soulsig <message>       # Add

/soulsig wipe            # Clear (permanent)

/soulsig heal            # Restore (if recent)

```

## 🎤 Voice Commands

### /voice
**Full voice mode (speak & listen)**
```bash

/voice

```
Exit: Say "voice off"

### /voice1
**OPSIIE speaks, you type**
```bash

/voice1

```

### /voice2
**You speak, OPSIIE types**
```bash

/voice2

```

### /voiceoff
**Disable voice mode**
```bash

/voiceoff

```

## 🎨 AI Generation Commands

### /imagine
**Generate images**
```bash

/imagine <description>

/imagine model                    # Check current model

/imagine model <model_name>       # Change model

```
**Examples**: `/imagine futuristic city`, `/imagine model hakurei/waifu-diffusion`

### /video
**Generate videos**
```bash

/video <description>

/video model                      # Check current model

/video model <model_name>         # Change model

```
**Examples**: `/video sunset timelapse`, `/video model zeroscope`

### /music
**Generate music**
```bash

/music <description>

```
**Examples**: `/music jazz piano`, `/music ambient soundscape`

## 📧 Communication Commands

### /mail
**Send emails**
```bash

/mail <emails> subject "<subject>" content "<message>"

```
**Examples**: 
- `/mail john@gmail.com subject "Hello" content "Test"`
- `/mail Ross subject "Update" content "Latest info"`

### /mail inbox
**View unread emails**
```bash

/mail inbox

```
Commands in inbox: number to read, `reply`, `inbox`, `exit`

## 📁 Document Commands

### /read
**Load and analyze files**
```bash

/read "<file_path>"

```
Supports: PDF, CSV, DOCX, TXT, XLSX
**Example**: `/read "C:\Documents\report.pdf"`

### /open
**Reopen last file context**
```bash

/open

```

### /close
**Close file context**
```bash

/close

```

## ⚙️ System Commands

### /status
**System diagnostics**
```bash

/status

```

### /theme
**Change color theme**
```bash

/theme

```
Options: Pastel, Vibrant

### /weblimit
**Set web content extraction limit**
```bash

/weblimit <number>

```
Range: 500-5000 characters
**Example**: `/weblimit 2000`

### /help
**Display help**
```bash

/help                    # Main menu

/help <command>          # Specific command help

```
**Examples**: `/help imagine`, `/help markets`

## 🤖 R-Grade: Agentic Network

### /ask
**Query AI agents**
```bash

/ask <agent> <prompt>

```
Agents: Nyx, G1, Kronos
**Examples**:
- `/ask Nyx Write Python blockchain code`
- `/ask G1 Analyze quantum computing`
- `/ask Kronos Greek audit procedures`

### /ask live
**Live voice conversations**
```bash

/ask g1 live             # G1 Black real-time voice

/ask kronos live         # Kronos real-time voice

```
Exit: Press Ctrl+C

### /room
**Create collaboration room**
```bash

/room <agent1, agent2...>: <theme>

```
**Examples**:
- `/room nyx, g1: Quantum computing applications`
- `/room nyx: Python microservices design`

Close room: `/close` (prompts to save as CSV)

## 📊 R-Grade: Financial Intelligence

### /markets
**Market data and analysis**
```bash

/markets <symbol>                  # Basic data

/markets <symbol> <extra>          # Detailed analysis

/markets compare <sym1> <sym2>     # Compare stocks

```

**Extras**: `statistics`, `history`, `profile`, `financials`, `analysis`, `options`, `holders`, `sustainability`

**Examples**:
- `/markets tesla`
- `/markets btc`
- `/markets shell statistics`
- `/markets compare tsla nio`

## 🧬 R-Grade: DNA Analysis

### /dna
**Analyze DNA/RNA/Protein sequences**
```bash

/dna <sequence> [options]

```

**Options**:
- `--verbose` - Detailed analysis
- `--type <dna|rna|protein>` - Force type
- `--format <format>` - Input format
- `--export <json|csv|txt>` - Export results
- `--homology` - Include similarity search
- `--structure` - Structure prediction
- `--patents` - Patent search
- `--literature` - Literature search

**Examples**:
- `/dna ATGCGTAACGGCATTAGC`
- `/dna --verbose --homology MAKVLISPKQW`
- `/dna --type rna AUGCGUAACGGCAUUAGC`

## 🔗 R-Grade: Web3 & Blockchain

### /0x buy
**Buy tokens**
```bash

/0x buy <amount> <token> using <token> on <chain>

```
**Example**: `/0x buy 10 degen using eth on base`

### /0x sell
**Sell tokens**
```bash

/0x sell <amount> <token> for <token> on <chain>

```
**Example**: `/0x sell 5 degen for eth on base`

### /0x send
**Send tokens**
```bash

/0x send <chain> <token> <amount> to <recipient>

```
**Example**: `/0x send base eth 0.1 to Ross`

### /0x receive
**View wallet addresses**
```bash

/0x receive

```

### /0x gas
**Set gas strategy**
```bash

/0x gas <low|medium|high>

```

### /0x new
**Add custom token/chain**
```bash

/0x new token <name> <chain> <address>

/0x new chain <name> <chain_id> <rpc_url>

```

### /0x forget
**Remove configuration**
```bash

/0x forget token <name>

/0x forget chain <name>

```
Note: Cannot remove Base, Ethereum, Polygon

## 🚪 Session Commands

### exit / quit
**Terminate OPSIIE session**
```bash

exit

quit

```
Do not use `/` prefix

## 📋 Command Categories

**All Users:**
- Memory: `/recall`, `/memorize`, `/forget`, `/soulsig`
- Voice: `/voice`, `/voice1`, `/voice2`, `/voiceoff`
- AI Gen: `/imagine`, `/video`, `/music`
- Email: `/mail`, `/mail inbox`
- Files: `/read`, `/open`, `/close`
- System: `/status`, `/theme`, `/weblimit`, `/help`

**R-Grade Only:**
- Agents: `/ask`, `/ask live`, `/room`
- Markets: `/markets`
- DNA: `/dna`
- Web3: `/0x`

## 🔑 Access Control

**R-Grade**: ARPA ID starts with 'R' (e.g., R001)
**A-Grade**: ARPA ID starts with 'A' (e.g., A001)

Check kun.py for your access level.

---

**Complete command reference.** 📚