siada-cli 1.7.0__tar.gz → 1.7.32b1__tar.gz

siada_cli-1.7.32b1/NOTICE

@@ -0,0 +1,318 @@
+Siada CLI
+Copyright 2026 Siada Team
+
+Siada CLI is licensed under the Apache License, Version 2.0. The full license
+text ships with every distribution (see LICENSE) and is also available at
+https://www.apache.org/licenses/LICENSE-2.0
+
+This NOTICE lists third-party software that is incorporated into, or
+redistributed with, Siada CLI, together with the attribution notices those
+licenses require. It is kept at the repository root because Python build
+backends (poetry-core) copy LICENSE / NOTICE files into the wheel metadata
+directory (.dist-info/licenses/), so this file ships with every built
+distribution.
+
+===============================================================================
+1. Source code incorporated or adapted from other open-source projects
+===============================================================================
+
+Cline - Apache License 2.0 - https://github.com/cline/cline
+    Referenced its prompt design and adapted tool usage and rules.
+    See docs/CREDITS.md for the project-level credit.
+
+Aider - Apache License 2.0 - https://github.com/Aider-AI/aider
+    Referenced its interaction approach and adapted @command handling,
+    streaming output and related behaviour; drew on its repository-map design.
+    See docs/CREDITS.md for the project-level credit.
+
+OpenHands - MIT License - https://github.com/All-Hands-AI/OpenHands
+    Copyright (c) 2025 OpenHands contributors (as stated in the upstream
+    LICENSE at https://github.com/All-Hands-AI/OpenHands/blob/main/LICENSE)
+    Code from its file-editing tool is quoted and adapted. The same
+    functionality is also redistributed as the `openhands-aci` 0.3.3 PyPI
+    dependency, which ships its own MIT license file.
+    See docs/CREDITS.md for the project-level credit.
+
+OpenAI Codex - Apache License 2.0 - https://github.com/openai/codex
+    Referenced its skills-module implementation (field limits, prompt
+    wording, skills-list rendering budget) and adapted it to the Siada
+    skills system.
+    The packaged GPT-6 prompt templates are modified versions of
+    model_messages.instructions_template entries in codex-rs/models-manager/models.json
+    at commit 2fdf047c9631c9ed01a31b62efb7891718a931a8.
+    Their modifications are documented in
+    siada/agent_hub/coder/prompt/models/gpt6/templates/README.md.
+    GPT-5 personality guidance also adapts
+    codex-rs/core/templates/personalities/gpt-5.2-codex_pragmatic.md and
+    gpt-5.2-codex_friendly.md at commit 2dbcab90e24bbe3c710ad41ffab7bb372256827b.
+    The identity and tool guidance are adapted to Siada.
+    Attribution text from the upstream NOTICE file
+    (https://github.com/openai/codex/blob/2fdf047c9631c9ed01a31b62efb7891718a931a8/NOTICE),
+    reproduced with normalized whitespace:
+
+        OpenAI Codex
+        Copyright 2025 OpenAI
+
+    (The upstream NOTICE file additionally carries a notice for code derived
+    from Ratatui. That notice covers Codex's Rust terminal UI, none of which is
+    used or adapted here, so per Apache License 2.0 section 4(d) - notices that
+    do not pertain to any part of the derivative work may be omitted - it is not
+    reproduced. If that changes, copy the Ratatui notice from the upstream
+    NOTICE file.)
+
+ZCode - Apache License 2.0 - https://github.com/zai-org/ZCode
+    Copyright 2026 Z.AI Co., Ltd (upstream LICENSE at the commit below).
+    The GLM-5.2-and-later prompt template
+    (siada/agent_hub/coder/prompt/models/glm/templates/system.md) copies the
+    identity and harness text (including the security notice) and the
+    communication and context-management sections of the public ZCode CLI at
+    commit 29628c9acdb81b703bbd4080c207a0e7ce5e276e
+    (apps/zcode-cli/packages/core/src/context/sections/identity.ts and
+    .../context/dynamic-sections.ts), and follows the environment-section layout
+    of .../context/sections/env-info.ts, with the product identity renamed to
+    Siada and Siada's own runtime facts, capabilities, safety rules and catalogs
+    rendered in place of ZCode's environment fields and tool sections. The CLI
+    prefix message (.../context/sections/cli-prefix.ts), the git-status snapshot
+    and the persistent-memory sections are not copied. This entry is also the
+    notice that the adapted files were changed, as Apache License 2.0 section
+    4(b) requires.
+    The todo reminder also adapts runtime/helpers/runtime-reminders.ts at
+    that commit; tool names and the reminder's presentation are changed for Siada.
+    The Apache-2.0 license is reproduced in docs/CREDITS.md, which ships in
+    the sdist and wheel. Upstream NOTICE.md points to THIRD-PARTY-NOTICES.md
+    for ZCode's own third-party (npm dependency) notices.
+    See docs/CREDITS.md for the project-level credit.
+
+Kimi Code - MIT License - https://github.com/MoonshotAI/kimi-code
+    Copyright (c) 2026 Moonshot AI (as stated in the upstream LICENSE at
+    https://github.com/MoonshotAI/kimi-code/blob/main/LICENSE)
+    Kimi Code's system-prompt template is adapted for Siada's Kimi K3-and-later
+    prompt (siada/agent_hub/coder/prompt/models/kimi_k3/templates/system.md);
+    runtime facts and the available tools are adapted to Siada. The MIT
+    permission notice that must accompany the adapted template is reproduced in
+    docs/CREDITS.md, which ships in the sdist and wheel.
+    See docs/CREDITS.md for the project-level credit.
+
+chrome-acp - MIT License - https://github.com/Areo-Joe/chrome-acp
+    Copyright (c) 2025 Areo-Joe (upstream LICENSE, retained verbatim in this
+    repository as chrome-acp/LICENSE; the same file is redistributed with the
+    browser add-on packages)
+    The Chrome extension (chrome-acp/packages/chrome-extension) and the local
+    proxy (chrome-acp/packages/proxy-server) are adapted for Siada. The
+    third-party components those artifacts bundle or install are listed in
+    chrome-acp/THIRD_PARTY_NOTICES.md.
+
+===============================================================================
+2. Bundled native executables
+===============================================================================
+
+ripgrep 14.1.1 - https://github.com/BurntSushi/ripgrep
+    Prebuilt ripgrep binaries for five platforms are redistributed inside the
+    Python package directory `siada/tools/coder/file_search/bin/`:
+    rg-macos-arm64, rg-macos-x64, rg-linux-x64, rg-linux-arm64 and rg.exe.
+    (All five binaries contain the version and revision strings "14.1.1" and
+    "4649aa9700"; the macOS arm64 binary reports "ripgrep 14.1.1 (rev
+    4649aa9700)", "features:+pcre2" and "PCRE2 10.43 is available (JIT is
+    available)" when executed.)
+    ripgrep is dual-licensed: "Dual-licensed under MIT or the UNLICENSE"
+    (upstream README). The MIT option is reproduced below; the UNLICENSE text
+    is available at https://github.com/BurntSushi/ripgrep/blob/master/UNLICENSE
+
+The MIT License (MIT)
+
+Copyright (c) 2015 Andrew Gallant
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+PCRE2 10.43 - https://github.com/PCRE2Project/pcre2
+    The ripgrep binaries above are built with PCRE2 support linked in: all five
+    binaries contain PCRE2 code, and the macOS arm64 binary reports
+    "PCRE2 10.43 is available (JIT is available)"; the string "10.43" is
+    present in the other four binaries as well. PCRE2 is distributed under the
+    "BSD" licence (3-clause) with an exemption for binary library-like
+    packages, https://github.com/PCRE2Project/pcre2/blob/pcre2-10.43/LICENCE -
+    the usual notice is reproduced below.
+
+PCRE2 LICENCE
+-------------
+
+PCRE2 is a library of functions to support regular expressions whose syntax
+and semantics are as close as possible to those of the Perl 5 language.
+
+Releases 10.00 and above of PCRE2 are distributed under the terms of the "BSD"
+licence, as specified below, with one exemption for certain binary
+redistributions. The documentation for PCRE2, supplied in the "doc" directory,
+is distributed under the same terms as the software itself. The data in the
+testdata directory is not copyrighted and is in the public domain.
+
+The basic library functions are written in C and are freestanding. Also
+included in the distribution is a just-in-time compiler that can be used to
+optimize pattern matching. This is an optional feature that can be omitted when
+the library is built.
+
+
+THE BASIC LIBRARY FUNCTIONS
+---------------------------
+
+Written by:       Philip Hazel
+Email local part: Philip.Hazel
+Email domain:     gmail.com
+
+Retired from University of Cambridge Computing Service,
+Cambridge, England.
+
+Copyright (c) 1997-2024 University of Cambridge
+All rights reserved.
+
+
+PCRE2 JUST-IN-TIME COMPILATION SUPPORT
+--------------------------------------
+
+Written by:       Zoltan Herczeg
+Email local part: hzmester
+Email domain:     freemail.hu
+
+Copyright(c) 2010-2024 Zoltan Herczeg
+All rights reserved.
+
+
+STACK-LESS JUST-IN-TIME COMPILER
+--------------------------------
+
+Written by:       Zoltan Herczeg
+Email local part: hzmester
+Email domain:     freemail.hu
+
+Copyright(c) 2009-2024 Zoltan Herczeg
+All rights reserved.
+
+
+THE "BSD" LICENCE
+-----------------
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notices,
+      this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright
+      notices, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+
+    * Neither the name of the University of Cambridge nor the names of any
+      contributors may be used to endorse or promote products derived from this
+      software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+
+
+EXEMPTION FOR BINARY LIBRARY-LIKE PACKAGES
+------------------------------------------
+
+The second condition in the BSD licence (covering binary redistributions) does
+not apply all the way down a chain of software. If binary package A includes
+PCRE2, it must respect the condition, but if package B is software that
+includes package A, the condition is not imposed on package B unless it uses
+PCRE2 independently.
+
+End
+
+===============================================================================
+3. Bundled JavaScript - terminal UI (siada_cli_ui/bundle/siada-ui.js)
+===============================================================================
+
+The terminal UI ships as a single minified esbuild bundle. The current build's
+own esbuild metafile (siada_cli_ui/bundle/esbuild-meta.json) records 999 inputs:
+998 files and the virtual module `devtools-stub:devtools-stub`. Excluding that
+virtual module and assigning each file to its owning npm package - by walking up to
+the nearest ancestor package.json that declares both `name` and `version` -
+yields 52 third-party install roots resolving to 50 distinct `name@version`
+packages, all matching the committed siada_cli_ui/package-lock.json, with no
+file input left without an owning package. devDependencies and type-only `@types/*`
+packages contribute no shipped code and are not part of that set.
+
+The complete package list for this bundle - package names, versions, SPDX
+license identifiers and the copyright/attribution lines quoted verbatim from
+each package's shipped LICENSE file - together with the full license texts, is
+maintained in siada_cli_ui/THIRD_PARTY_NOTICES.md. The bundling step
+(siada_cli_ui/esbuild.config.js) copies that file next to the bundle as
+siada_cli_ui/bundle/siada-ui.LEGAL.txt, and the pyproject include pattern
+`siada_cli_ui/bundle/*.LEGAL.txt` ships it in the sdist and wheel:
+siada-ui.LEGAL.txt is the authoritative list of the bundle's conservative
+package input closure; inputs can still be removed during tree shaking.
+
+This section therefore does not repeat a package table. Earlier revisions of
+this NOTICE carried a 71-row table assembled from the runtime dependency
+closure of siada_cli_ui/package.json (plus one dev-flagged package) and
+presented as if that closure were included in the bundle. That table was
+over-inclusive (it listed runtime dependencies the current bundle does not
+inline) and stale for the current build: packages the bundle does inline - for
+example `ink`, `terminal-size`, `widest-line` and `emoji-regex` - were absent,
+and some rows named versions other than the ones the bundle uses (for example
+`cli-truncate` 4.0.0 where the bundle has 5.2.0, and `ansi-regex` 5.0.1 where
+the bundle has 6.2.2). It has been superseded by the audited list in
+siada-ui.LEGAL.txt.
+
+The historical over-inclusive attributions are preserved so that nothing the
+earlier table attributed is dropped: siada_cli_ui/THIRD_PARTY_NOTICES.md keeps
+an "Additional upstream attributions" table for the packages recorded in
+siada_cli_ui/package-lock.json that are not current bundle inputs (the rest of
+the runtime dependency closure, plus one dev-flagged package), and the bundle
+copy siada-ui.LEGAL.txt carries the same list.
+
+esbuild also preserves the `@license` banners of the files it inlines at the
+end of bundle/siada-ui.js; among them:
+    react / react-reconciler / scheduler - MIT - Copyright (c) Meta Platforms, Inc. and affiliates.
+    @jrichman/ink build/scroll.js, layout.js, selection.js - Apache-2.0 - Copyright 2025 Google LLC
+    fzf 0.5.2 - BSD 3-Clause - Copyright (c) 2021 Ajit
+
+===============================================================================
+4. Browser add-on artifacts (chrome-acp)
+===============================================================================
+
+The extension zip, the proxy tarball and the PWA assets built from
+chrome-acp/ redistribute their own third-party components (React, motion,
+shiki, streamdown, Mozilla pdf.js, the proxy's npm runtime dependencies, ...).
+Their notices and license texts are listed in
+chrome-acp/THIRD_PARTY_NOTICES.md; the adapted chrome-acp source itself
+remains under the MIT license shown in chrome-acp/LICENSE.
+
+===============================================================================
+5. Attribution material shipped with Siada CLI
+===============================================================================
+
+LICENSE ............................. Apache License 2.0 (Siada CLI)
+docs/CREDITS.md ..................... project-level credits and license texts
+siada_cli_ui/THIRD_PARTY_NOTICES.md . terminal-UI bundle notices and license
+                                      texts (copied at bundle time to
+                                      siada_cli_ui/bundle/siada-ui.LEGAL.txt,
+                                      which ships in the sdist and wheel)
+chrome-acp/LICENSE .................. MIT license of the adapted browser add-on
+chrome-acp/THIRD_PARTY_NOTICES.md ... browser add-on third-party notices

siada_cli-1.7.32b1/PKG-INFO

@@ -0,0 +1,311 @@
+Metadata-Version: 2.4
+Name: siada-cli
+Version: 1.7.32b1
+Summary: Siada CLI is a Ai Pair Programming Tool in terminal
+License: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Requires-Python: >=3.12,<3.14
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Dist: agent-client-protocol (==0.11.0)
+Requires-Dist: aiohttp (>=3.8.0,<4.0.0)
+Requires-Dist: apscheduler (>=3.10.0,<4.0.0)
+Requires-Dist: click (>=8.2.1,<9.0.0)
+Requires-Dist: concurrent-log-handler (>=0.9.25,<1.0.0)
+Requires-Dist: configargparse (>=1.7,<2.0.0)
+Requires-Dist: diskcache (==5.6.3)
+Requires-Dist: drawille (>=0.1.0,<1.0.0)
+Requires-Dist: fastapi (>=0.110.0,<1.0.0)
+Requires-Dist: gitpython (>=3.1.0,<4.0.0)
+Requires-Dist: grep-ast (>=0.9.0,<1.0.0)
+Requires-Dist: httpx[socks] (>=0.27.0,<1.0.0)
+Requires-Dist: jieba (>=0.42.0,<1.0.0)
+Requires-Dist: lark-oapi (>=1.6.7,<2.0.0)
+Requires-Dist: litellm (==1.83.0)
+Requires-Dist: mcp (==1.26.0)
+Requires-Dist: networkx (>=3.5.0,<4.0.0)
+Requires-Dist: openai (==3.0.0)
+Requires-Dist: openai-agents (==0.22.3)
+Requires-Dist: openhands-aci (==0.3.3)
+Requires-Dist: partial-json-parser (>=0.2.1.1.post6,<1.0.0)
+Requires-Dist: patch-ng (>=1.18.1,<2.0.0)
+Requires-Dist: pathspec (>=0.12.0,<1.0.0)
+Requires-Dist: pexpect (>=4.9.0,<5.0.0)
+Requires-Dist: playwright (>=1.40.0,<2.0.0)
+Requires-Dist: prompt-toolkit (>=3.0.51,<4.0.0)
+Requires-Dist: psutil (>=7.0.0,<8.0.0)
+Requires-Dist: pydantic (>=2.12.5,<3.0.0)
+Requires-Dist: pydantic-settings (>=2.2.0,<3.0.0)
+Requires-Dist: pygments (>=2.19.1,<3.0.0)
+Requires-Dist: pyobjc-framework-Cocoa (>=10.0) ; sys_platform == "darwin"
+Requires-Dist: requests (>=2.31.0,<3.0.0)
+Requires-Dist: rich (>=13.0.0,<=14.1.0)
+Requires-Dist: ruamel-yaml (>=0.18.0,<1.0.0)
+Requires-Dist: scipy (>=1.11.2,<2.0.0)
+Requires-Dist: shtab (>=1.7,<2.0.0)
+Requires-Dist: termcolor (>=3.1.0,<4.0.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: tqdm (>=4.67.1,<5.0.0)
+Requires-Dist: trafilatura (>=2.0.0,<3.0.0)
+Requires-Dist: uvicorn (>=0.27.0,<1.0.0)
+Description-Content-Type: text/markdown
+
+# Siada CLI
+
+**[简体中文](./docs/zh-CN/README_zh.md) | English**
+
+[![PyPI version](https://img.shields.io/pypi/v/siada-cli)](https://pypi.org/project/siada-cli/)
+[![Python versions](https://img.shields.io/badge/python-3.12%20%E2%80%93%203.13-blue)](https://www.python.org/downloads/)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
+
+**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](#news) · [Capabilities](#what-siada-can-do) · [Quick start](#quick-start) · [Browser preview](#browser-collaboration-preview) · [Documentation](#documentation)
+
+[![Preview: from terminal conversation to browser action in Siada CLI](./docs/assets/demos/siada-chrome-home-desktop-v2-preview.gif)](./docs/assets/demos/siada-chrome-home-desktop-v2.mp4?raw=1)
+
+[Explore the browser collaboration showcase and user guide](https://liauto-siada.github.io/siada-cli/). 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.
+
+| Workflow | Demonstrated result | Full video |
+| --- | --- | --- |
+| Reading → Feishu sharing | Organize a daily article selection, retain source links, and share it with a study group. | [▶ 30 s](./docs/assets/demos/siada-reading-to-feishu.mp4?raw=1) |
+| Browsing history → Paper comparison | Recover relevant research and compare it with five key insights in a survey, with explanations and comparisons placed in the original page. | [▶ 28 s](./docs/assets/demos/siada-history-to-paper.mp4?raw=1) |
+| Recent actions → Browsing path | Summarize recorded clicks, scrolling, searches, and page navigation in a readable reply. | [▶ 28 s](./docs/assets/demos/siada-human-action-perception.mp4?raw=1) |
+| Current page → Inline explanation | Put translations, annotations, and comparisons beside the corresponding paragraphs. | [▶ 28 s](./docs/assets/demos/siada-history-to-paper.mp4?raw=1) |
+| Financial reports → Feishu report | Compare quarterly and annual revenue, gross margin, and cash flow, then organize analysis, charts, and sources in a document. | [▶ 32 s](./docs/assets/demos/siada-financial-report.mp4?raw=1) |
+| Product research → Presentation | Collect product images and specifications, compare prices and features, and produce buying recommendations as Feishu slides. | [▶ 34 s](./docs/assets/demos/siada-ecommerce-to-ppt.mp4?raw=1) |
+| Browser search → Trace review | Find agent dependencies, versions, and sources in a GitHub project's `pyproject.toml`, then inspect the actions and their timing. | [▶ 36 s](./docs/assets/demos/siada-browser-control-trace.mp4?raw=1) |
+
+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 |
+| --- | --- |
+| [![Preview: reading, organizing, and sharing to Feishu](./docs/assets/demos/siada-reading-to-feishu-preview.gif)](./docs/assets/demos/siada-reading-to-feishu.mp4?raw=1) | [![Preview: browsing history, paper comparison, and inline explanation](./docs/assets/demos/siada-history-to-paper-preview.gif)](./docs/assets/demos/siada-history-to-paper.mp4?raw=1) |
+
+| Recent actions → Context · 28 s | Financial reports → Feishu · 32 s |
+| --- | --- |
+| [![Preview: recent clicks, scrolling, and browsing paths](./docs/assets/demos/siada-human-action-perception-preview.gif)](./docs/assets/demos/siada-human-action-perception.mp4?raw=1) | [![Preview: financial analysis and a Feishu report](./docs/assets/demos/siada-financial-report-preview.gif)](./docs/assets/demos/siada-financial-report.mp4?raw=1) |
+
+| Product research → Slides · 34 s | Browser search → Trace · 36 s |
+| --- | --- |
+| [![Preview: product research and Feishu slides](./docs/assets/demos/siada-ecommerce-to-ppt-preview.gif)](./docs/assets/demos/siada-ecommerce-to-ppt.mp4?raw=1) | [![Preview: browser search and Trace review](./docs/assets/demos/siada-browser-control-trace-preview.gif)](./docs/assets/demos/siada-browser-control-trace.mp4?raw=1) |
+
+See [Browser collaboration preview](#browser-collaboration-preview) for the integration overview. Follow [Releases](https://github.com/liauto-siada/siada-cli/releases) and [PyPI](https://pypi.org/project/siada-cli/) for published versions.
+
+## What Siada Can Do
+
+| Capability | How it helps |
+| --- | --- |
+| Code development and debugging | Explore a repository, implement features, fix defects, and run relevant checks across languages and frameworks. |
+| Long tasks and sub-agents | Plan complex work, delegate bounded tasks to specialized agents, and track progress toward a goal. |
+| Model choice | Use different model families and configure custom API endpoints through the provider layer. |
+| Persistent memory | Retain preferences, project context, and decisions across sessions, with a structured fact store for retrieval and feedback. |
+| Skills, agents, and MCP | Add reusable workflows, specialized sub-agents, and tools from external MCP servers. |
+| Session control | Resume conversations, compact context, and opt into checkpoints for recovery. |
+| Multiple entry points | Work in the terminal, connect an ACP client, or send tasks through a configured Feishu/Lark bot. |
+| Scheduled automation | Use the background daemon for recurring tasks and proactive workflows. |
+
+## Quick Start
+
+### Requirements
+
+| Requirement | Details |
+| --- | --- |
+| Operating system | macOS, Linux, or Windows |
+| Python | 3.12–3.13; the installation command selects Python 3.12 |
+| GCC | 11+ on macOS / Linux |
+| Package manager | [uv](https://docs.astral.sh/uv/) |
+| Model access | A configured provider account or your own API key |
+
+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**:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+Or on **Windows (PowerShell)**:
+
+```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:
+
+```bash
+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:
+
+```bash
+cd path/to/your/project
+siada-cli
+```
+
+Complete the provider, model, and API key setup when prompted, then describe a task:
+
+```text
+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](./docs/USERMANUAL.md) and [External Model Configuration](./docs/external_model_configuration.md) for details.
+
+### Update or Uninstall
+
+```bash
+uv tool upgrade siada-cli
+```
+
+```bash
+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.
+
+| Entry point | Usage |
+| --- | --- |
+| Interactive terminal | Run `siada-cli` for a continuous conversation in the terminal UI. |
+| Script or CI task | Run `siada-cli --prompt "Find and fix the failing tests"` for a single task. |
+| ACP client | Configure the client to launch `siada-acp` as its agent process. |
+| Feishu / Lark | Configure a bot, then send tasks from chat; see the [Remote Control Guide](./docs/remote_control_lark.md). |
+| Browser preview | A development preview requiring the browser addon and Chrome extension; see the [integration overview](#browser-collaboration-preview). |
+
+### Common Commands
+
+Enter these commands inside an interactive session:
+
+| Command | Purpose |
+| --- | --- |
+| `/help` | List available commands. |
+| `/model` | Select or change the model. |
+| `/resume` | Browse and resume saved sessions. |
+| `/clear` | Start a fresh conversation context. |
+| `/compact` | Compact the current conversation. |
+| `/skill-list` | List available skills. |
+| `/skill-reload` | Reload skills after adding or editing them. |
+| `/goal <objective>` | Set a goal for the session; use `/goal clear` to clear it. |
+
+Enable checkpoints when starting an interactive session:
+
+```bash
+siada-cli --checkpointing
+```
+
+Checkpoints are opt-in and are unavailable in non-interactive mode. See the [User Manual](./docs/USERMANUAL.md) 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:
+
+```bash
+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](./docs/browser-installation.md) for source installation, candidate artifact testing, and release details.
+
+## Development
+
+Install Python 3.12 or 3.13, [Poetry](https://python-poetry.org/docs/#installation), and a maintained Node.js LTS release with npm. Node.js 24 LTS satisfies the current UI dependencies.
+
+```bash
+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`.
+
+| Directory | Responsibility |
+| --- | --- |
+| `siada/entrypoint/` | CLI arguments and startup |
+| `siada/acp_server/` | ACP agent server |
+| `siada/agent_hub/` | Agents and orchestration |
+| `siada/tools/`, `siada/services/` | Tools and application services |
+| `siada/provider/` | Model provider integrations |
+| `siada_cli_ui/` | Terminal UI |
+| `tests/`, `docs/` | Tests and documentation |
+
+## Documentation
+
+| Document | Contents |
+| --- | --- |
+| [User Manual](./docs/USERMANUAL.md) | Configuration, usage modes, commands, checkpoints, and troubleshooting |
+| [Skills](./docs/SKILLS.md) | Create and manage reusable workflows |
+| [Custom Agents](./docs/USER_AGENTS.md) | Define specialized sub-agents and their tools, models, and skills |
+| [External Model Configuration](./docs/external_model_configuration.md) | Connect custom models and API endpoints |
+| [Feishu / Lark Remote Control](./docs/remote_control_lark.md) | Configure the bot transport and chat access |
+| [Compaction Configuration](./docs/compaction_configuration.md) | Configure conversation compression |
+| [Contributing](./docs/CONTRIBUTING.md) | Development conventions and contribution workflow |
+
+## Contributing
+
+Bug fixes, features, documentation improvements, and reusable skills are welcome. Read the [Contributing Guide](./docs/CONTRIBUTING.md) for the contribution agreement and pull request requirements, and use [GitHub Issues](https://github.com/liauto-siada/siada-cli/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](https://github.com/openai/openai-agents-python) — agent framework.
+- [LiteLLM](https://github.com/BerriAI/litellm) — model provider integration.
+- [OpenHands ACI](https://github.com/OpenHands/OpenHands) — agent tools.
+- [Gemini CLI](https://github.com/google-gemini/gemini-cli) — inspiration for terminal agent design.
+- [Agent Client Protocol](https://agentclientprotocol.com/) — integration with agent clients.
+
+See [CREDITS.md](./docs/CREDITS.md) for the full acknowledgements and license information.
+
+## License
+
+Distributed under the [Apache License 2.0](LICENSE).
+
+## Disclaimers
+
+See [disclaimers.md](./docs/disclaimers.md).
+
+---
+
+<div align="center">
+Built with care by Li Auto Code Intelligence Team and the open source community
+</div>
+