# AgentOS — Development Sandbox

Mix of Agents development workspace. Iterate here first, then promote to AgentOS production.

## Quick Start

1. Double-click **`Install Mix of Agents.bat`** and enter your API endpoint, model, and key.
2. Double-click any **`Start *.bat`** file to launch an agent.

## What to Click

| File | What it does |
|------|-------------|
| `Install Mix of Agents.bat` | First-time setup: configures provider, model, and API key |
| `Start AgentOS.bat` | PowerShell console — primary development agent (OS) |
| `Start AgentOSP.bat` | Python console — optional Python agent (OSP) |
| `Start AgentOSH.bat` | Browser UI — drag-and-drop visual front-end (OSH) |
| `Start Dashboard.bat` | Launches the AgentOS Dashboard web UI |

> **No `.bat` allowed?** See the **PowerShell Direct** section below.

## Agent Variants

| Agent | Script | Runtime | Description |
|-------|--------|---------|-------------|
| OS | `Scripts\AgentOS.ps1` | PowerShell | Primary development console |
| OSX | `Scripts\AgentOSX.ps1` | PowerShell | Fast-iteration console (shares skills/config with OS) |
| OSH | `Scripts\AgentOSH_Chat.html` | Browser | Drag-and-drop UI front-end |
| OSP | `Scripts\AgentOSP.py` | Python | Optional Python console agent |

## PowerShell Direct (no .bat required)

If policy blocks `.bat` execution, open PowerShell and run directly:

```powershell
# Navigate to the AgentOS folder
cd "D:\path\to\AgentOS"

# Launch AgentOS (primary PowerShell agent)
powershell -NoProfile -ExecutionPolicy Bypass -File "Scripts\AgentOS.ps1"

# Launch AgentOSX (fast-iteration PowerShell agent)
powershell -NoProfile -ExecutionPolicy Bypass -File "Scripts\AgentOSX.ps1"

# Run the installer
powershell -NoProfile -ExecutionPolicy Bypass -File "Scripts\Install-Mix-of-Agents.ps1"

# Launch OSH browser UI
powershell -NoProfile -ExecutionPolicy Bypass -File "Scripts\Launch-AgentOSH.ps1"

# Launch the Dashboard
powershell -NoProfile -ExecutionPolicy Bypass -File "Adapters\UI\LiveDashboard\Launch-Dashboard.ps1" -Port 8000
```

## Python Direct (no .bat required)

```powershell
# Using bundled portable Python
.\Tools\Python\python.exe Scripts\AgentOSP.py

# Using system Python
python Scripts\AgentOSP.py
```

## Install

Double-click `Install Mix of Agents.bat`, then enter:

1. Chat completions endpoint URL
2. Default model id
3. API key

The installer writes:

- `Config/provider.json` — endpoint/model metadata, no raw key
- `Config/GenAI_Key.txt` — local API key file; do not share

## Self-tests

PowerShell agents support `-SelfTest` and interactive `/selftest`. Python supports `python Scripts\AgentOSP.py --selftest`.

## Folder Structure

```
AgentOS/
  Install Mix of Agents.bat    ← Click this first
  Start AgentOS.bat           ← Click this to launch
  Start AgentOSP.bat          ← Click this for Python agent
  Start AgentOSH.bat          ← Click this for browser UI
  Start Dashboard.bat          ← Click this for the Dashboard
  README.md / README.html      ← You are here
  Scripts/                     ← All .ps1, .py, and .html scripts
  Config/                      ← Provider settings, API keys
  Skills/                      ← PowerShell and Python skill modules
  Adapters/                    ← Dashboard and UI adapters
  Library/                     ← JavaScript libraries for browser UI
  Tools/                       ← Bundled portable Python runtime
  Installers/                  ← Python installer archive
  Memory/                      ← Chat history and long-term context
  Mailbox/                     ← Inter-agent message queue
  State/                       ← Runtime state and sessions
  Logs/                        ← Execution logs
  Outputs/                     ← Generated deliverables
  Deliverables/                ← Completed briefs and reports
  Projects/                    ← Workspace project files
  Workspace/                   ← Active working files
  Tests/                       ← Test harness
```

## Workspace Roles

- **AgentOS** (this workspace): development sandbox. Iterate constantly, test features here first.
- **AgentOS** (`Working/AgentOS/`): production/stable. Promote validated changes there using `Deploy-ToProduction.ps1`.
- Use `Deploy-Mirror.ps1` to refresh this workspace from the AgentOS production directory.

## Cautions

This is an executable reconstruction, not a production-hardened product. Runtime state and secrets are local-only. OSH/browser assets are included where recoverable, but the primary supported agents are OS, OSX, and OSP.