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
8 changes: 6 additions & 2 deletions desktop-sidecar/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,15 @@

Minimal Compose Multiplatform desktop app for watching the local `agent-task-queue` database in real time.

The sidecar reads the existing SQLite queue DB directly and shows:
The sidecar reads the existing SQLite queue DB directly and also inspects live task queue
server args plus `adb devices -l` when available. It shows:

- running tasks
- waiting tasks
- exact queues grouped by root scope so hierarchical queue activity is easier to understand
- configured `--queue-capacity` scopes, including empty queues and slot counts
- agent/context identity for live servers and tasks when queue metadata is available, with process inspection as a fallback
- connected ADB devices so emulator queue plans can be compared with reality

It is intentionally read-only. There is no new MCP protocol or server surface.

Expand All @@ -33,4 +37,4 @@ Use a specific queue directory with:
## Notes

- `./gradlew` in this directory delegates to the checked-in Gradle wrapper under `../intellij-plugin/` so the sidecar stays lightweight.
- Queue capacities configured with `--queue-capacity` are process-local and are not persisted in `queue.db`, so the app visualizes live tasks and queue layout rather than stored capacity numbers.
- Queue capacities configured with `--queue-capacity` are still process-local and are not persisted in `queue.db`; the app surfaces them by reading the args of live task queue server processes for the selected data dir.
1 change: 1 addition & 0 deletions desktop-sidecar/build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ kotlin {
implementation(compose.foundation)
implementation(compose.material3)
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.10.2")
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
implementation("org.xerial:sqlite-jdbc:3.53.0.0")
}
}
Expand Down
Loading