Siada CLI

简体中文 | English

Siada CLI is an AI assistant for coding, debugging, and automation. It works with your project, tools, and persistent memory to carry tasks from investigation through implementation and verification. It can also control your browser and perceive your intent from your current reading and recent actions.

News · Capabilities · Quick start · Browser preview · Documentation

Explore the browser collaboration showcase and user guide. The showcase links back to this GitHub repository.

News

Siada: Human in browser use

AI's value is not in replacing people, but in making room for creativity.

Development preview: the browser addon and Chrome extension are not yet included in public main or the published PyPI package. The workflows below come from the browser collaboration demos. Feishu outputs require the relevant skills and authorization.

The browser collaboration preview brings Siada into the page you are reading. Your current reading, browsing history, and recent actions provide context for understanding, organizing, and creating.

Understand your intent. Find previously visited papers, GitHub projects, and articles, then compare them with the current page. Read recorded clicks, scrolling, and navigation to answer questions about what you just did.

Make room to create. Place translations, explanations, and comparisons beside the relevant paragraphs. Turn information from the web into reports, presentations, pages, or tools using the skills and integrations you have configured.

Browse efficiently. Search, navigate, and extract information across pages. Trace lets you inspect action snapshots, tool execution time, and intervals between calls to review the process.

Click an animated preview to open the full MP4. The six demos are silent, with Chinese on-screen captions; the paper comparison demo also shows inline explanations.

Reading → Feishu · 30 s	Browsing history → Paper · 28 s

Recent actions → Context · 28 s	Financial reports → Feishu · 32 s

Product research → Slides · 34 s	Browser search → Trace · 36 s

See Browser collaboration preview for the integration overview. Follow Releases and PyPI for published versions.

What Siada Can Do

Quick Start

Requirements

The terminal UI uses Node.js 24 LTS. Install Node.js yourself for terminal-only use, or use the runtime installed by siada-browser setup with a published browser platform package. The launcher does not download Node.js on startup. Source development and browser builds also need npm and Bun.

Install

Install uv on macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Or on Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Install the published Siada CLI package with the same command on all platforms:

uv tool install --force --python python3.12 --compile --with pip siada-cli@latest
uv tool update-shell

Open a new terminal if siada-cli is not yet on PATH.

Start a Task

Launch Siada in the project you want to work on:

cd path/to/your/project
siada-cli

Complete the provider, model, and API key setup when prompted, then describe a task:

Find the cause of the failing tests, fix it, and run the relevant test suite.

Use /model to select an available model. Configuration lives in ~/.siada-cli/conf.yaml; custom model definitions live in ~/.siada-cli/models.json. See the User Manual and External Model Configuration for details.

Update or Uninstall

uv tool upgrade siada-cli

uv tool uninstall siada-cli

Usage Modes

Sub-agents retry up to twice when a response ends with reasoning and an empty final answer. Retries continue the existing session with completed tool results. If all three attempts return this result, the task is marked failed. This check detects a potentially incomplete response; it does not establish a network fault.

Common Commands

Enter these commands inside an interactive session:

Enable checkpoints when starting an interactive session:

siada-cli --checkpointing

Checkpoints are opt-in and are unavailable in non-interactive mode. See the User Manual for restore, undo, and comparison commands.

Browser Collaboration Preview

The preview connects a Chrome extension to a local proxy and the Siada ACP agent. ACP handles the agent conversation; MCP exposes browser tools for reading pages, navigating, capturing snapshots, and adding inline annotations. Browser actions and page snapshots can be reviewed in Trace.

This checkout adds a browser platform package containing Node.js, the proxy, its production dependencies, the web client, and the Chrome extension. The packages have not yet been published or verified through the release workflow. Once the matching release is available, install with:

siada-browser setup

Load ~/.siada-cli/browser/extension manually through chrome://extensions and enter the setup token in the extension settings. After uv tool upgrade siada-cli, run siada-browser setup again and reload the extension in Chrome. See Browser installation for source installation, candidate artifact testing, and release details.

Development

Install Python 3.12 or 3.13, Poetry, and a maintained Node.js LTS release with npm. Node.js 24 LTS satisfies the current UI dependencies.

git clone https://github.com/liauto-siada/siada-cli.git
cd siada-cli
poetry install --with dev
npm --prefix siada_cli_ui ci
npm --prefix siada_cli_ui run build:all
poetry run siada-cli

Rebuild the UI after changing its source; the launcher uses the bundled UI. To run the standalone ACP agent from the checkout, use poetry run siada-acp.

Documentation

Contributing

Bug fixes, features, documentation improvements, and reusable skills are welcome. Read the Contributing Guide for the contribution agreement and pull request requirements, and use GitHub Issues to report a problem or propose a change.

Acknowledgements

Thanks to the open source projects and contributors that make Siada possible, including:

• OpenAI Agents SDK — agent framework.
• LiteLLM — model provider integration.
• OpenHands ACI — agent tools.
• Gemini CLI — inspiration for terminal agent design.
• Agent Client Protocol — integration with agent clients.

See CREDITS.md for the full acknowledgements and license information.

License

Distributed under the Apache License 2.0.

Disclaimers

See disclaimers.md.