octopus-release/README.md

# Octopus

The AI coding agent built for the terminal.

## Install

**Unix (Linux/macOS):**

```bash
curl -fsSL https://eightarms.net/Octopus/octopus-release/raw/branch/main/install | bash
```

**Windows (PowerShell):**

```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://eightarms.net/Octopus/octopus-release/raw/branch/main/install.ps1 | iex
```

### Manual install

If the one-liner fails with a connection error, the direct connection to `eightarms.net` is likely being filtered on your network. Download the archive for your platform from the [releases page](https://eightarms.net/Octopus/octopus-release/releases/latest) and install it manually instead.

**Unix (Linux/macOS):**

```bash
# after downloading octopus-<platform>.tar.gz from the releases page
tar -xzf octopus-linux-x64.tar.gz
sudo mv octopus /usr/local/bin/
octopus --version
```

**Windows (PowerShell):**

After downloading `octopus-windows-x64.zip` from the releases page:

```powershell
$zip = "$env:USERPROFILE\Downloads\octopus-windows-x64.zip"
$dest = "$env:USERPROFILE\.octopus\bin"
$tmp  = Join-Path $env:TEMP "octopus_manual"
New-Item -ItemType Directory -Force -Path $dest,$tmp | Out-Null
Expand-Archive -Path $zip -DestinationPath $tmp -Force
Copy-Item "$tmp\octopus.exe" "$dest\octopus.exe" -Force
Remove-Item -Recurse -Force $tmp
$p = [Environment]::GetEnvironmentVariable('Path','User')
if ($p -notlike "*$dest*") { [Environment]::SetEnvironmentVariable('Path', ($p.TrimEnd(';') + ";$dest"), 'User') }
& "$dest\octopus.exe" --version
```

Open a **new** terminal and run `octopus`.

## Desktop (beta)

Prefer a GUI? The Octopus desktop app ships Windows and Linux beta builds alongside the CLI:

- **Windows:** download [`octopus-desktop-win-x64.exe`](https://eightarms.net/Octopus/octopus-release/releases/download/desktop-beta/octopus-desktop-win-x64.exe) from the [`desktop-beta` channel](https://eightarms.net/Octopus/octopus-release/releases/tag/desktop-beta) and run the installer. Installed builds auto-update themselves from the same channel.
- **Linux (x86_64):** download [`octopus-desktop-linux-x86_64.AppImage`](https://eightarms.net/Octopus/octopus-release/releases/download/desktop-beta/octopus-desktop-linux-x86_64.AppImage) from the same [`desktop-beta` channel](https://eightarms.net/Octopus/octopus-release/releases/tag/desktop-beta), make it executable and run it:

  ```bash
  chmod +x octopus-desktop-linux-x86_64.AppImage
  ./octopus-desktop-linux-x86_64.AppImage
  ```

  The AppImage auto-updates itself from the same channel (`latest-linux.yml`). `deb`/`rpm` packages are built and verified in CI but not published to this channel yet.
- This is a beta channel — expect rough edges. macOS builds are on the way but not published yet.

## Documentation

Visit the [documentation](https://eightarms.net/Octopus/octopus/wiki) for usage guides and API reference.

## Workflow

Curious how Octopus organizes agent work? Read about the **ticket-driven workflow system** (in Chinese): [docs/workflow.zh.md](docs/workflow.zh.md)

## Development

The source code and issue tracker are available at the [private development repository](https://eightarms.net/Octopus/octopus).

## License

MIT License — see the source repository for details.