feat(cli): add boxlite serve — REST API server#357
Merged
DorianZheng merged 2 commits intoboxlite-ai:mainfrom Mar 11, 2026
Merged
feat(cli): add boxlite serve — REST API server#357DorianZheng merged 2 commits intoboxlite-ai:mainfrom
DorianZheng merged 2 commits intoboxlite-ai:mainfrom
Conversation
Holds a single BoxliteRuntime and exposes box lifecycle + exec operations
over HTTP. Solves runtime lock contention when multiple callers need
concurrent access (e.g. Pinix Server executing nested clip-to-clip calls).
Endpoints (9, MVP):
- GET /v1/config
- POST /v1/local/boxes (create)
- GET /v1/local/boxes (list)
- GET /v1/local/boxes/{id} (info)
- POST /v1/local/boxes/{id}/start
- POST /v1/local/boxes/{id}/stop
- POST /v1/local/boxes/{id}/exec (returns execution_id, supports stdin)
- GET /v1/local/boxes/{id}/executions/{eid}/output (SSE stream)
- DELETE /v1/local/boxes/{id}
SSE exec protocol:
event: stdout, data: {"data":"<base64>"}
event: stderr, data: {"data":"<base64>"}
event: exit, data: {"exit_code":0,"duration_ms":1234}
Co-Authored-By: Claude Opus 4.6 (1M context) <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
boxlite servecommand — a long-running REST API server that holds a singleBoxliteRuntimestdinfield for piping input to commandsMotivation
When Pinix Server forks
boxlite execCLI for eachClipService.Invoke, each process creates its ownBoxliteRuntimeand acquires~/.boxlite/.lock. Nested calls (clip A invoking clip B through the same server) cause deadlock.boxlite serveeliminates this by holding a single runtime instance.Test plan
cargo build -p boxlite-clicargo clippy -p boxlite-cli -- -D warningsboxlite serve --port 8100+ curl endpoints--boxlite-restflag, clip-to-clip nested calls verifiedGenerated with Claude Code