Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -79,6 +79,7 @@ jobs:
sudo apt-get update
sudo apt-get install -y \
cmake \
libdbus-1-dev \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libayatana-appindicator3-dev \
Expand Down Expand Up @@ -144,6 +145,7 @@ jobs:
sudo apt-get update
sudo apt-get install -y \
cmake \
libdbus-1-dev \
libwebkit2gtk-4.1-dev \
libgtk-3-dev \
libayatana-appindicator3-dev \
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -181,7 +181,7 @@ jobs:
- name: install dependencies (linux only)
run: |
sudo apt-get update
sudo apt-get install -y cmake libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf libfuse2 xdg-utils libasound2-dev rpm
sudo apt-get install -y cmake libdbus-1-dev libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf libfuse2 xdg-utils libasound2-dev rpm

- name: setup node
uses: actions/setup-node@v4
Expand Down
32 changes: 23 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,23 @@ OpenCode Monitor is an independent community project and is not affiliated with

**Active development** — core REST/SSE support is live for thread/session lifecycle, event translation, messaging, model discovery, approvals, and image attachments. Remaining work is parity polish and OpenCode-specific UX cleanup.

## Install

Download the latest packaged build from [GitHub Releases](https://github.com/jacobjmc/OpenCodeMonitor/releases).

Current release targets:

- macOS Apple Silicon
- Windows x64
- Linux x64 / arm64 (`AppImage` and `rpm`)

## Requirements

### 1) OpenCode CLI (required)

This app expects a running OpenCode server (`opencode serve`). Install OpenCode first:
OpenCode Monitor uses your local `opencode` CLI installation and manages its own local `opencode serve` process automatically. You do not need to start the server yourself.

Install OpenCode first:

```bash
# Recommended (macOS/Linux)
Expand All @@ -30,29 +42,31 @@ Then verify the CLI:
opencode --version
```

### 2) Local tooling for development
### 2) Local tooling for development only

- Node.js 20+
- npm 10+
- Rust stable toolchain (`cargo`)

## First Run

1. Start OpenCode server in a separate terminal:
1. Install the `opencode` CLI and confirm `opencode --version` works in your terminal.

```bash
opencode serve --port 4040
```
2. Launch OpenCode Monitor.

3. Open `Settings -> OpenCode` if you want to verify the managed server status. The app starts and monitors its own local OpenCode server, which defaults to `http://127.0.0.1:14096`.

4. Add a workspace and start a thread.

2. Start OpenCode Monitor:
## Development

To run from source:

```bash
npm install
npm run tauri:dev
```

3. In Settings -> Server, ensure the backend URL points to your OpenCode server (default: `http://127.0.0.1:4040`).

## Architecture

- **Frontend**: React 19 + Vite + TypeScript
Expand Down
11 changes: 11 additions & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,17 @@
"name": "opencode-monitor",
"private": true,
"version": "0.1.1",
"description": "Desktop app for monitoring and interacting with OpenCode agents across multiple workspaces",
"license": "MIT",
"author": "Jacob",
"homepage": "https://github.com/jacobjmc/OpenCodeMonitor",
"repository": {
"type": "git",
"url": "https://github.com/jacobjmc/OpenCodeMonitor.git"
},
"bugs": {
"url": "https://github.com/jacobjmc/OpenCodeMonitor/issues"
},
"type": "module",
"scripts": {
"sync:material-icons": "node scripts/sync-material-icons.mjs",
Expand Down
Loading