Prompt Queue
Published Updated
What is Prompt Queue?
Orbit’s prompt queue is the per-project line of numbered prompts waiting for a coding agent. Prompts run one at a time per project, and nothing runs until you approve it.
A list of prompts waiting to run, one at a time, in order. Nothing executes until you approve it. The queue is per-project — each project has its own.
The Queue is where prompts go when staged or queued. You write a prompt, it lands in the queue, you review it, then approve it. The queue runner picks up approved prompts and dispatches them to the assigned coding agent. This sequential structure prevents AI agents from racing or conflicting on the same project.
How it relates to Orbit
Orbit stores per-project numbered prompts in a SQLite queue and runs them one at a time per project. See The Prompt Queue for details.
When you would use it
The Queue is your primary interaction surface in Orbit. Every prompt you run goes through it.
Common operations
- Staging a new prompt for review before approving
- Approving prompts to run
- Cancelling prompts that should no longer execute
- Reviewing prompt history and outcomes
Frequently asked questions
Where is the prompt queue stored?
In SQLite at ~/.orbit/queue.db, so it survives restarts and never re-runs work it already finished.
Why did my prompt get a different number than I typed?
A prompt claims its per-project number when it is inserted, not when you draft it, so prompts queued in parallel can take the number first.
Can one prompt wait for another?
Yes. Add depends_on: #N and the prompt waits until #N ships; pre-approve it and it starts by itself. See Queue & Approval.
Related terms
Where this is taught
No learning path uses this term yet. Browse the Learning Atlas for guided sequences through related ideas.