Terminal & AI Agents

Drive Terminals From the Command Line

Run `onedevtool terminal` from any shell to list your in-app agent tabs, poll one for idle or busy, submit a prompt, and close a tab when it is done. Every submit returns a submission id and the agent's readiness, and the exit code separates “written to a ready composer” from “likely queued behind the current turn”.

Screenshot coming soon

Why You Need This

How this feature boosts your daily productivity

Scripting an agent is only useful if the script can tell what happened. `onedevtool terminal submit` now prints a submission id plus the readiness of the agent at the moment the prompt landed, and exits 3 rather than 0 when the composer looked busy — so a caller waits instead of assuming the work started. `status` polls one tab in a single shot, and `close` shuts a tab and its process down, refusing seats a live orchestration team is using and pointing at the proper stop command instead. A prompt 1DevTool is holding for your confirmation reports that it is awaiting approval rather than reading as delivered. Turn the CLI on under Settings → Terminal → “Enable local onedevtool terminal CLI”.

How It Works

Get started in 4 simple steps

1
1

Turn the CLI on

Settings → Terminal → "Enable local onedevtool terminal CLI" exposes the onedevtool terminal command to any shell on this machine.

2
2

Find the tab you want

`onedevtool terminal list --json` returns your in-app agent tabs, each row carrying a status of idle, busy, unknown or closed.

3
3

Send a prompt and read the receipt

`onedevtool terminal submit --id=<id> --prompt-stdin` prints a submission id and the agent readiness at the moment the prompt landed.

4
4

Branch on the exit code

Exit 0 means the prompt went into a ready composer; exit 3 means it was written while the agent looked busy and is likely queued behind the current turn.

5
5

Poll, then close

`onedevtool terminal status --id=<id>` is a one-shot readiness check; `close --id=<id>` ends the tab and its process, refusing seats a live team is using.

Without 1DevTool

The manual way vs. the 1DevTool way

The Hard Way

# Fire a prompt at a terminal from a script
# Get exit 0 and learn nothing
# Not know whether the agent was even ready
# Poll by scraping output, or just sleep 30
# Kill a tab and take a live team member with it
# Treat a held prompt as delivered

The 1DevTool Way

onedevtool terminal status — idle | busy | unknown | closed.
submit returns a submission id and a readiness field.
Exit 3 means queued behind the current turn, not delivered.
close refuses seats a live team is using.

Key Capabilities

Everything included with Drive Terminals From the Command Line

List your in-app agent tabs from any shell with `onedevtool terminal list`
Poll one tab for idle, busy, unknown or closed with `terminal status`
Submit a prompt from stdin to a named terminal id
Get a submission id back as proof the prompt was written
Read the agent’s readiness at the moment the prompt landed
Separate “written to a ready composer” from “likely queued” by exit code
Close a tab and its process with `terminal close`
Have a close refused when a live orchestration team owns that seat
See a held prompt reported as awaiting your approval rather than delivered
Get JSON output from every subcommand with `--json`

Why It Matters

The productivity impact of having terminal & ai agents built into your workspace

Exit 0 Finally Means Something

A submit that lands in a busy composer exits 3 instead of 0, so a script can wait for the current turn rather than assuming its prompt is being worked on.

Proof, Not Hope

Every submit returns a submission id and the readiness at the moment it landed — a receipt you can log, rather than the absence of an error.

Teams Do Not Lose Members To A Script

Closing a tab that a live orchestration seat is using is refused and redirected to the proper stop command, so automation cannot quietly break a running team.

Held Is Not Delivered

A prompt waiting on your confirmation says so, instead of reporting success and leaving the caller waiting for a reply that cannot come.

Ready to boost your workflow?

Download 1DevTool for free and experience Drive Terminals From the Command Line along with 170 other features — all in one app.