Guides › Start here
Quickstart
Install the CLI, sign in through the browser and talk to an agent in five minutes. Then do the same thing through the API.
1. Install the CLI#
The CLI needs Node.js 18 or newer and runs on macOS and Linux.
curl -fsSL https://doublex.ai/cli/install.sh | shThe installer puts the doublex command in ~/.doublex and creates a shortcut in ~/.local/bin. It doesn't use sudo, and it saves this app's address as the default. Check it:
doublex --version2. Sign in#
doublex loginThe browser opens the authorization page. Check the computer name and click Allow. That's it: the CLI stores a key just for this terminal in the system keychain. To check who's signed in:
doublex whoami3. Talk to an agent#
List the agents you can use:
doublex agents listID NAME MODEL SCOPE CHATS CAN EDIT
agt_8f3a2b1c9d0e 🤖 Assistant openrouter/auto personal 12 yes
agt_2b7e4c6a1f3d 📊 CRM Analyst anthropic/claude-sonnet-5-5 team 4 noPick an ID and send a message. The answer shows up while the agent writes, and the tools it uses appear with ›:
doublex sessions create agt_8f3a2b1c9d0e --input "What is our refund policy?"At the end, the CLI shows the conversation ID. To continue the same conversation:
doublex sessions send task_5d2c9a3e1f07 --input "Summarize this in a short email to the customer"4. Do the same through the API#
Generate a key in Settings › Profile › API access › Generate API key and store it in an environment variable:
export DOUBLEX_API_KEY="dbx_..."List the agents:
curl https://doublex.ai/api/agents \
-H "Authorization: Bearer $DOUBLEX_API_KEY"Send a message. The answer arrives as NDJSON, one JSON event per line:
curl -N https://doublex.ai/api/agents/agt_8f3a2b1c9d0e/chat \
-H "Authorization: Bearer $DOUBLEX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "What is our refund policy?"}'{"type":"task","taskId":"task_5d2c9a3e1f07"}
{"type":"tool_start","id":"toolu_01","name":"buscar_conhecimento","label":"Searching the knowledge base"}
{"type":"tool_end","id":"toolu_01","ok":true}
{"type":"text","delta":"Under the current policy, refunds are available for 30 days "}
{"type":"done","status":"completed"}Next steps#
- API keys: key types, where to generate them and how to store them.
- Conversations in the API: every streaming event and how to cancel.
- Webhooks: run an agent when another system calls a URL.
- Coding agents: teach Claude Code or Codex to use the CLI.