Skip to content
Merged
Show file tree
Hide file tree
Changes from 9 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