A command-line interface for interacting with Doubao AI through browser automation.
Built on top of bb-browser — a CLI + MCP server for programmatic browser control.
No Node.js required. Download the binary for your platform from GitHub Releases:
# Linux (x86_64) curl -fsSL https://github.com/ChHsiching/doubao-cli/releases/latest/download/doubao-cli-linux-amd64 \ -o doubao-cli && chmod +x doubao-cli # macOS (Apple Silicon) curl -fsSL https://github.com/ChHsiching/doubao-cli/releases/latest/download/doubao-cli-darwin-arm64 \ -o doubao-cli && chmod +x doubao-cli # macOS (Intel) curl -fsSL https://github.com/ChHsiching/doubao-cli/releases/latest/download/doubao-cli-darwin-amd64 \ -o doubao-cli && chmod +x doubao-cli # Windows (x86_64) # Download doubao-cli-windows-amd64.exe from the Releases page
npm install -g @chhsiching/doubao-cli
git clone git@github.com:ChHsiching/doubao-cli.git
cd doubao-cli
npm install- Google Chrome or Chromium
- A Doubao account
# Phone + verification code (recommended) doubao-cli login 13800138000 # Send code to phone doubao-cli login 13800138000 123456 # Login with code # Or interactive mode — prompts for phone and code doubao-cli login
If phone login is unavailable, use browser login as a fallback:
doubao-cli login --web
A Chrome window opens for manual login. After completing login, press Enter in the terminal.
After login, verify with:
doubao-cli account
doubao-cli "hello" # Quick chat doubao-cli image "a cat wearing sunglasses" # Generate image doubao-cli translate --to-english "你好" # Translate doubao-cli coding "write quicksort" # Coding mode doubao-cli math "solve x^2 + 3x - 4 = 0" # Math mode doubao-cli help # All commands
| Command | Description |
|---|---|
doubao-cli "message" |
Send a message |
doubao-cli image <desc> |
AI image generation |
doubao-cli translate <text> |
Translation |
doubao-cli translate --to-english <text> |
Translate to English |
doubao-cli translate --to-chinese <text> |
Translate to Chinese |
doubao-cli coding <prompt> |
Code assistant |
doubao-cli math <problem> |
Math solver |
doubao-cli writing <prompt> |
Writing assistant |
doubao-cli research <topic> |
Deep research |
doubao-cli ppt <topic> |
PPT generation |
doubao-cli login |
Login (interactive) |
doubao-cli login --web |
Login (browser) |
doubao-cli list |
List conversations |
doubao-cli new |
New conversation |
doubao-cli last |
Last response |
doubao-cli retry |
Regenerate response |
doubao-cli account |
Account info |
doubao-cli uses bb-browser to drive a local Chrome instance via the Chrome DevTools Protocol. It operates entirely within your own browser session — no API keys, no third-party servers, no data leaves your machine.
This project is created for educational and personal learning purposes only.
It is a browser automation tool that helps users interact with their own web sessions via the command line. It does not bypass authentication, scrape data at scale, or access any non-public APIs.
The name "doubao" refers to the Doubao web application for identification purposes only. This project is not affiliated with, endorsed by, or connected to ByteDance or the Doubao team.
Users are solely responsible for ensuring their use complies with the terms of service of any web platform.
AGPL-3.0-only · Copyright (c) 2026 ChHsiching — see LICENSE.
- Use (including internal commercial use), modification, and distribution are free. Distributing it or offering it as a network service requires derivative works to be open-sourced under AGPL-3.0.
- Closed-source commercial use requires a separate commercial license: hsichingchang@gmail.com
By submitting a PR, you agree to license your contribution under AGPL-3.0 and grant the maintainer the right to offer separate commercial licenses. Your contribution remains available to everyone under AGPL.