alysis-code 0.15.2__tar.gz → 0.16.0__tar.gz

alysis_code-0.16.0/.gitignore

@@ -0,0 +1,73 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+/native/git-ssh-sign/target/
+/native/windows-sandbox/vendor/srt-win/target-qa/
+
+# Virtualenv
+.venv/
+venv/
+.tmp_ci*/
+
+# Tooling
+.dev/
+.worktrees/
+.pytest_cache/
+.pytest-*/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+node_modules/
+.alysis/
+# legacy (pre-rebrand) runtime dirs: still produced by older installs
+.sylliptor/
+.sylliptor_data_demo/
+.sylliptor_images/
+sylliptor-feedback/
+.alysis_data_demo/
+.alysis_data_demo_verify/
+.alysis_images/
+alysis-feedback/
+reports/
+qa_reports/
+.qa-results/
+/outputs/
+/private-attestation/
+.workflow-release-dist/
+benchmark_results/
+benchmarks/terminal_bench/artifacts/
+
+# VS Code extension generated artifacts
+extensions/*/.vscode-test/
+extensions/*/node_modules/
+extensions/*/out/
+extensions/*/*.vsix
+
+# Local review/context bundles
+# Retired internal report directories, regardless of artifact format.
+/docs/internal/
+/docs/subagents/
+/docs/tooling/
+*_context_review.zip
+owner-scoping.patch
+alysis_ecs.tar.gz
+sylliptor_ecs.tar.gz
+
+# Claude Code local config
+.claude/
+.codex/
+
+# OS / IDE
+.DS_Store
+.idea/
+.vscode/
+
+# Secrets / env
+.env
+.env.*

alysis_code-0.16.0/NOTICE

@@ -0,0 +1,8 @@
+Alysis Code
+Copyright 2026 AlysisAi
+
+This product is licensed under the Apache License, Version 2.0.
+
+The bundled Windows sandbox incorporates Microsoft Windows Sandbox tooling,
+Copyright (c) Microsoft Corporation, under the MIT License. The license and
+exact source inventory accompany the helper in alysis_code/assets/windows-mxc.

alysis_code-0.16.0/PKG-INFO

@@ -0,0 +1,355 @@
+Metadata-Version: 2.4
+Name: alysis-code
+Version: 0.16.0
+Summary: Open-source AI coding agent for your terminal. Bring any model, sandboxed by default.
+Project-URL: Homepage, https://alysiscode.com/
+Project-URL: Documentation, https://alysiscode.com/docs
+Project-URL: Changelog, https://github.com/AlysisAi/AlysisCode/blob/main/docs/CHANGELOG.md
+Project-URL: Funding, https://github.com/sponsors/AlysisAi
+Project-URL: Issues, https://github.com/AlysisAi/AlysisCode/issues
+Project-URL: Security, https://github.com/AlysisAi/AlysisCode/blob/main/.github/SECURITY.md
+Project-URL: Source, https://github.com/AlysisAi/AlysisCode
+License: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: agent,ai,ai-agent,ai-coding-agent,cli,coding-agent,developer-tools,llm,local-llm,mcp,ollama,sandbox,terminal,tui
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: anyio>=4.14.2
+Requires-Dist: brotli>=1.2.1; platform_python_implementation == 'CPython'
+Requires-Dist: brotlicffi>=1.2.1.0; platform_python_implementation != 'CPython'
+Requires-Dist: certifi>=2026.10.19
+Requires-Dist: click>=8.0.0
+Requires-Dist: cryptography>=50.0.0
+Requires-Dist: ddgs>=9.0.0
+Requires-Dist: dulwich==1.2.19; sys_platform == 'win32'
+Requires-Dist: httpcore<2.0.0,>=1.0.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: markdown-it-py<5.0.0,>=4.2.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: pillow>=13.0.0
+Requires-Dist: platformdirs>=4.2.0
+Requires-Dist: prompt-toolkit>=3.0.43
+Requires-Dist: psutil<8.0,>=7.2.2
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pygments<3.0.0,>=2.17.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.7.1
+Requires-Dist: tiktoken>=0.7.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: websockets<17.0,>=15.0
+Provides-Extra: dev
+Requires-Dist: dulwich==1.2.19; extra == 'dev'
+Requires-Dist: editables==0.5; extra == 'dev'
+Requires-Dist: hatchling==1.31.0; extra == 'dev'
+Requires-Dist: jsonschema>=4.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.6.0; extra == 'dev'
+Provides-Extra: documents
+Requires-Dist: lxml==6.1.3; extra == 'documents'
+Requires-Dist: markdown-it-py==4.2.0; extra == 'documents'
+Requires-Dist: openpyxl==3.1.5; extra == 'documents'
+Requires-Dist: pypdfium2==5.13.0; extra == 'documents'
+Requires-Dist: python-docx==1.2.0; extra == 'documents'
+Requires-Dist: python-pptx==1.0.2; extra == 'documents'
+Requires-Dist: reportlab==4.4.9; extra == 'documents'
+Requires-Dist: xlsxwriter==3.2.9; extra == 'documents'
+Provides-Extra: managed-build
+Requires-Dist: pyinstaller-hooks-contrib==2026.6; extra == 'managed-build'
+Requires-Dist: pyinstaller==6.21.0; extra == 'managed-build'
+Requires-Dist: setuptools>=84.1.0; extra == 'managed-build'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.115; extra == 'server'
+Requires-Dist: python-multipart>=0.0.9; extra == 'server'
+Requires-Dist: uvicorn[standard]>=0.30; extra == 'server'
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.svg">
+    <img src="docs/assets/banner.svg" alt="Alysis Code — Everyone's Coding Agent" width="640">
+  </picture>
+</p>
+
+<p align="center">
+  An open-source agent for coding, research, and everyday workflows.<br>
+  <strong>Multiple models. Our own sandbox. One independently built engine.</strong>
+</p>
+
+<p align="center">
+  <a href="https://alysiscode.com/">Website</a> ·
+  <a href="https://alysiscode.com/docs">Documentation</a> ·
+  <a href="docs/quickstart.md">Quickstart</a> ·
+  <a href="docs/CHANGELOG.md">Changelog</a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/AlysisAi/AlysisCode/stargazers"><img src="https://img.shields.io/github/stars/AlysisAi/AlysisCode?style=flat&logo=github" alt="GitHub stars"></a>
+  <a href="https://github.com/AlysisAi/AlysisCode/actions/workflows/ci.yml"><img src="https://github.com/AlysisAi/AlysisCode/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/alysis-code/"><img src="https://img.shields.io/pypi/v/alysis-code.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/alysis-code/"><img src="https://img.shields.io/pypi/dm/alysis-code.svg" alt="PyPI downloads"></a>
+  <a href="https://pypi.org/project/alysis-code/"><img src="https://img.shields.io/pypi/pyversions/alysis-code.svg" alt="Python versions"></a>
+  <a href="https://github.com/AlysisAi/AlysisCode/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/alysis-code.svg" alt="License"></a>
+</p>
+
+<p align="center">
+  <a href="https://x.com/alysiscode">Follow on X</a> ·
+  <a href="https://github.com/sponsors/AlysisAi">Sponsor the project</a>
+</p>
+
+<p align="center">
+  <img src="docs/assets/demo.gif" alt="Alysis Code CLI welcome screen followed by a short conversation" width="960">
+  <br>
+  <sub>From the welcome screen to your first conversation. Real CLI recording; pauses shortened.</sub>
+</p>
+
+---
+
+## Get Started
+
+Alysis Code requires **Python 3.11+** and runs on macOS, Linux, and Windows.
+
+**1 — Install**
+
+On Windows, paste this into **PowerShell**:
+
+```powershell
+irm https://raw.githubusercontent.com/AlysisAi/AlysisCode/main/scripts/install.ps1 | iex
+```
+
+On Linux, macOS, or inside a **WSL/Ubuntu terminal**:
+
+```sh
+curl -LsSf https://raw.githubusercontent.com/AlysisAi/AlysisCode/main/scripts/install.sh | sh
+```
+
+The installers provision uv and Python 3.12 when needed. No existing Python or pipx is required.
+PowerShell can use `alysis` immediately; after the shell installer, follow its PATH instructions
+or open a new terminal. If you already use pipx, `pipx install alysis-code` also works;
+run `pipx ensurepath` and restart your terminal if the command is missing.
+Already installed? Run `alysis update` to get the latest release.
+
+**2 — Choose how to connect to a model**
+
+Pick one path. You can switch later with `/config` or by re-running `alysis-code setup`.
+
+*Path A — Your own API key or a local model (no Alysis account needed)*
+
+```bash
+cd your-project
+alysis-code
+```
+
+The first run opens a guided setup wizard. Choose **Use an API key**, connect a provider
+(OpenAI, Anthropic, DeepSeek, Gemini, OpenRouter, and more), and pick your default model.
+To run fully offline, point Alysis Code at a local endpoint (Ollama, LM Studio, vLLM) from the
+`/config` picker, which lists every preset. Prefer to configure it by hand?
+
+```bash
+export ALYSIS_API_KEY="YOUR_KEY"
+alysis config set base_url "https://api.openai.com/v1"
+alysis config set model "gpt-4.1-mini"
+```
+
+Have a ChatGPT subscription instead? Choose **Use an AI subscription** in the wizard, or run
+`alysis auth login openai-codex`.
+
+*Path B — Alysis account*
+
+```sh
+alysis login
+```
+
+Approve the code in your browser to use your Alysis credits. No provider key and no cloud
+environment variables are needed.
+
+**3 — Start working**
+
+```bash
+cd your-project
+alysis-code chat                            # interactive agent session
+alysis-code run "Fix the failing tests"     # coding task
+alysis-code run "Summarize the notes in this folder into a project brief"
+```
+
+(`alysis` works too, as a short alias.) The `/config` picker lists every provider preset.
+Full walkthrough: [Quickstart guide](docs/quickstart.md).
+
+## Alysis Code App
+
+Alysis Code App is powered by the open-source Alysis Code engine, bringing an agentic desktop experience to coding and broader everyday work.
+
+---
+
+## Why Alysis Code
+
+Alysis Code combines **our own sandbox**, **multiple model providers**, and **general-purpose
+workflows** in an independently built, Apache-2.0 agent. Build software, research a question,
+prepare documents, or automate work from the same terminal.
+
+- **[Our own Alysis Sandbox](#alysis-sandbox)** — command execution is sandboxed by default, with
+  Alysis-maintained container images and native OS backends. Permissions, network restrictions,
+  and repository protection give you concrete controls over what the agent can do.
+- **[Multi-model by design](https://alysiscode.com/docs/config/models)** — use OpenAI, Anthropic,
+  Gemini, DeepSeek, Qwen, Mistral, OpenRouter, xAI, and more. Connect your own key without an Alysis
+  account, or use Ollama, LM Studio, or vLLM for local inference. Choose the model that fits the task.
+- **General workflows, too** — research with [built-in web search](docs/web-search.md), turn notes
+  into briefs, and automate tasks across your files. Optional [document tools](docs/reference.md#optional-document-tools)
+  add PDF, Word, spreadsheet, and presentation workflows. Web search needs no separate API key;
+  model usage follows your provider's pricing.
+- **An independently built agent engine** — our runtime, Forge orchestration, subagent system,
+  terminal interface, and sandbox layer are developed by Alysis AI. The open-source CLI lets you
+  inspect, extend, and run the engine yourself.
+- **[Forge: turn a plan into verified changes](docs/forge.md)** — execute tasks in dependency order,
+  retain verification and review evidence, and resume interrupted runs. Strict verification blocks
+  integration when checks fail; independent tasks can run in parallel with `forge swarm`.
+- **[Parallel work you can inspect before applying](docs/subagents.md#parallel-writers-and-pinned-verification)**
+  — isolated workers prepare changes in separate Git worktrees. A verifier can check the exact
+  candidate while your working tree stays unchanged; applying it runs host-side conflict checks.
+- **[Extend the whole workflow](https://alysiscode.com/docs/concepts/plugins)** — package skills,
+  custom tools, MCP servers, hooks, and specialist subagents together in a declarative plugin manifest.
+
+## Alysis Sandbox
+
+**Our agent. Our sandbox. Your control.** Alysis Sandbox is our own open-source execution layer,
+with Alysis-maintained container images and Docker, Linux Bubblewrap, or macOS Seatbelt backends.
+Shell and verification commands default to strict sandboxing. The runtime enforces these boundaries
+outside the model, so command protection does not depend on the model following a safety prompt.
+
+- **Controlled execution.** Networking defaults to `off`; the macOS backend still permits localhost.
+  Docker commands drop Linux capabilities and do not inherit the host environment by default.
+  The CLI refuses execution when no backend is available unless you explicitly configure a fallback.
+- **Our own development images.** `ghcr.io/alysisai/alysis-sandbox` provides `base`, `dev`, and
+  `server` variants. The image build uses pinned, verified inputs for both AMD64 and ARM64;
+  deployments can pin an image digest for repeatable environments.
+- **Protection beyond approval prompts.** Repository metadata protection and the command denylist
+  remain separate from permission modes, including `fullaccess`.
+
+Set up and check your sandbox:
+
+```bash
+alysis sandbox setup
+alysis sandbox doctor --smoke
+```
+
+The sandbox covers shell and verification execution; the workspace remains writable for the task.
+See the [sandbox guide](docs/shell_sandbox.md) for backend differences and setup, and the
+[image build](scripts/sandbox/README.md) for the supply-chain details.
+
+## How it compares
+
+Comparing current terminal agents: **Claude Code, Codex CLI, OpenCode, Command Code, and Kilo Code**.
+Alysis Code brings together **our own sandbox with strict defaults**, **multiple providers and local
+models**, and **coding and general workflows**. For larger coding tasks, Forge adds coordinated
+execution, isolated worktrees, and verification before integration — in an independently built,
+Apache-2.0 engine.
+
+| Agent | Model choice | Coordinating larger tasks | Execution controls |
+| --- | --- | --- | --- |
+| **Alysis Code** | **Multiple providers + local models** | **Forge plans, parallel worktrees, verify-before-apply, conflict checks** | **Alysis Sandbox: strict by default, own images + native backends** |
+| Claude Code | [Claude models](https://code.claude.com/docs/en/model-config) | [Subagents and experimental agent teams](https://code.claude.com/docs/en/agent-teams) | [Sandboxed Bash with filesystem and network controls](https://code.claude.com/docs/en/sandboxing) |
+| Codex CLI | [OpenAI + local models](https://learn.chatgpt.com/docs/developer-commands?surface=cli); [custom providers](https://learn.chatgpt.com/docs/model-catalogs) | [Parallel subagents with configurable roles](https://learn.chatgpt.com/docs/agent-configuration/subagents) | [Sandbox and approval policies](https://learn.chatgpt.com/docs/developer-commands?surface=cli) |
+| OpenCode | [Multiple providers + local models](https://opencode.ai/docs/providers/) | [Build/Plan agents and parallel subagents](https://opencode.ai/docs/agents/) | [Permissions; use an external container or VM for isolation](https://github.com/anomalyco/opencode/blob/dev/SECURITY.md) |
+| Command Code | [Multiple providers + local models (BYOK beta)](https://commandcode.ai/docs/byok) | [Parallel custom subagents, including General, Explore, and Plan](https://commandcode.ai/docs/agents) | [Local permission rules](https://commandcode.ai/docs/permissions); separate [cloud execution (beta)](https://commandcode.ai/docs/cloud) |
+| Kilo Code | [Multiple providers + local models](https://kilo.ai/docs/ai-providers) | [Parallel agents and specialist modes](https://kilo.ai/cli) | [Opt-in OS sandbox on macOS/Linux; unavailable on Windows](https://kilo.ai/docs/getting-started/settings/sandboxing) |
+
+Based on the linked official documentation, checked **October 25, 2026**. This compares the CLI
+workflows, not every desktop or cloud feature. Capabilities and defaults vary by platform and
+configuration; the table is not a performance benchmark.
+
+## Permissions & Personas
+
+Two layers control what the agent may do — one enforces, one focuses.
+
+**Permissions** are the enforcement layer. Choose one per command with `--mode`, select the next
+message's level in chat with `/permissions` or **Shift+Tab**, or set a default with
+`alysis-code config set default_mode <mode>`. A selection takes effect when the next user message
+starts; it does not change a turn already running:
+
+| Mode | Behavior |
+| --- | --- |
+| `readonly` | Inspection plus top-level read-only delegation — no file writes, shell, MCP, candidate apply/discard, or nested delegation. |
+| `review` | The safe default — previews and asks before every write and shell command. |
+| `auto` | Applies routine edits with fewer prompts; dangerous operations stay blocked. |
+| `fullaccess` | No mode-level prompts for trusted workspaces — the denylist and audit log stay active. |
+
+**Personas** are working postures layered on top. Switch with `/persona`, or cycle with **Tab** in
+the TUI:
+
+| Persona | Posture |
+| --- | --- |
+| `code` | Implementation — the default, full coding workflow. |
+| `architect` | Planning and design — may write markdown documents only. |
+| `ask` | Read-only questions and codebase exploration. |
+| `debug` | Reproduce the failure first, then fix minimally and rerun the reproduction. |
+
+A persona is a convention, never a permission: it can keep or lower your execution mode, but can
+never raise it. Define your own in `.alysis_personas/*.md`.
+[Learn more](https://alysiscode.com/docs/concepts/personas)
+
+Use `/persona architect` for planning in chat, or `/forge` for a plan-driven execution workflow.
+The former chat `/plan` commands have been removed; Forge retains its plan views and editor.
+Persona changes made during a running turn apply after that turn finishes.
+
+## Project Links
+
+- [Website](https://alysiscode.com/)
+- [Documentation](https://alysiscode.com/docs) — also mirrored in [docs/](docs/README.md)
+- [Changelog](docs/CHANGELOG.md)
+- [Contributing](.github/CONTRIBUTING.md) — local setup and PR expectations
+- [Security policy](.github/SECURITY.md) — report vulnerabilities privately, never through public issues
+
+## License
+
+Apache-2.0. You're free to use, modify, and distribute this code, including commercially, as long as
+you keep the attribution and license notices. See [LICENSE](LICENSE) and [NOTICE](NOTICE).
+The shared editor sidebar includes MIT-licensed adaptations from Kilo Code/OpenCode; retain its
+[third-party notices](extensions/shared-ui/THIRD_PARTY_NOTICES.txt).
+
+## FAQ
+
+<details>
+<summary><b>Where did Alysis Code come from?</b></summary>
+
+Alysis Code's agent engine is independently built by the Alysis AI team, not forked from another
+coding agent. This includes the runtime, Forge orchestration, subagent system, terminal interface,
+and sandbox layer. The project uses third-party libraries, and the shared editor sidebar includes
+the adaptations credited in [our third-party notices](extensions/shared-ui/THIRD_PARTY_NOTICES.txt).
+Safety comes from enforced permissions, sandbox boundaries, and verification controls.
+</details>
+
+<details>
+<summary><b>Is Alysis Code really open source?</b></summary>
+
+Yes. The entire CLI is Apache-2.0 licensed. Bring your own API key from any supported provider, or
+run fully offline against a local endpoint — nothing in the agent requires a paid account.
+</details>
+
+More questions? See the [full FAQ](https://alysiscode.com/docs/faq).
+
+---
+
+**Join the community** — [X](https://x.com/alysiscode) | [GitHub Issues](https://github.com/AlysisAi/AlysisCode/issues)
+
+
+## Editor integrations
+
+[VS Code](extensions/vscode-alysis/README.md) uses the shared Alysis sidebar and Python IDE bridge.
+[JetBrains](extensions/jetbrains-alysis/README.md) is a development preview with a smaller feature set.
+The VS Code Marketplace pre-release is pending production signing and acceptance; see the
+[IDE release status](docs/vscode-marketplace-launch.md) before installing component packages.