dblx

CLI for dblebox — thread-first communication.

Usage

The CLI uses a verb-first command structure:

bunx dblx <verb> <noun> [options]

Examples:

dblx get threads
dblx get threads <thread-id>
dblx get threads --q "planning"
dblx get today
dblx create thread --title "New thread"
dblx set thread 12345678 --title "Renamed"

Command Model

Read operations use get:

dblx get ...

Write operations use create, set, and invite:

dblx create ...
dblx set ...
dblx invite ...

This keeps permission boundaries clear for agents and automation. A tool can be granted dblx get ... without also gaining write access.

Authentication

Generate an API key from Settings > API Keys in the dblebox web app, then:

dblx auth login

You'll be prompted for your key (starts with dblx_). Credentials are saved to ~/.config/dblx.json.

dblx auth whoami
dblx auth logout

You can also set DBLEBOX_API_KEY and DBLEBOX_API_URL environment variables instead of using auth login.

Read Commands

Threads

dblx get threads
dblx get threads <thread-id>
dblx get threads --archived
dblx get threads --snoozed
dblx get threads --archived --snoozed
dblx get threads --q "plan"
dblx get threads --q "#dblebox" --archived --snoozed

Get All Thread Content, Including Comments and Notes

dblx get threads <thread-id>

Today

dblx get today
dblx get today --date 2026-03-01

Notes

dblx get thread-note <thread-id>
dblx get today-note
dblx get today-note --date 2026-03-01

Comments

dblx get comments --thread <thread-id>

Members

dblx get members <thread-id>

Write Commands

Threads

dblx create thread --title "New thread"
dblx create thread --title "..." --comment "First message"
dblx create thread --title "..." --note "Draft spec..."

dblx set thread <thread-id> --title "New title"
dblx set thread <thread-id> --archived true
dblx set thread <thread-id> --archived false
dblx set thread <thread-id> --snoozed-until 2026-03-01T09:00:00
dblx set thread <thread-id> --snoozed-until none

Notes

Reading and writing notes are separate commands.

dblx set thread-note <thread-id> --content "Updated note"
dblx set today-note --content "My note"
dblx set today-note --date 2026-03-01 --content "My note"

Relationships

dblx set thread-parent <thread-id> --parent <parent-id>
dblx set thread-today <thread-id> --date 2026-03-01
dblx set thread-today <thread-id> --remove
dblx set thread-today <thread-id> --date 2026-03-01 --remove

Comments

dblx create comment --thread <thread-id> --body "Hello"
dblx set comment <comment-id> --body "Updated text"

Members

dblx invite member <thread-id> --user [email protected]

JSON Output

All read commands support --json for machine-readable output:

dblx get threads --json
dblx get threads <thread-id> --json
dblx get threads --q "plan" --json
dblx get today --json
dblx get thread-note <thread-id> --json