seedcode-cli 9.1.0__tar.gz → 9.2.0__tar.gz

{seedcode_cli-9.1.0 → seedcode_cli-9.2.0}/.gitignore

@@ -64,6 +64,11 @@ Desktop.ini
 .claude/
 
 # Scratch / temporary artifacts (never part of a release)
+# _verify/ holds throwaway virtualenvs and clean-home install tests used while
+# validating a release build. It must stay out of the tree's package inputs:
+# hatchling's sdist includes untracked, non-ignored files, so leaving a scratch
+# venv here would otherwise end up inside the source distribution.
+_verify/
 *.tmp
 *.bak
 *.orig

seedcode_cli-9.2.0/PKG-INFO

@@ -0,0 +1,496 @@
+Metadata-Version: 2.4
+Name: seedcode-cli
+Version: 9.2.0
+Summary: Seed Code — a premium terminal-based AI coding assistant. Plant ideas. Grow code.
+Project-URL: Homepage, https://github.com/Alshahriar-07/seedcode-cli
+Project-URL: Repository, https://github.com/Alshahriar-07/seedcode-cli
+Project-URL: Documentation, https://github.com/Alshahriar-07/seedcode-cli#readme
+Project-URL: Issues, https://github.com/Alshahriar-07/seedcode-cli/issues
+Project-URL: Changelog, https://github.com/Alshahriar-07/seedcode-cli/releases
+Author-email: Al Shahriar Sowan <github@eagox.studio>
+License-Expression: PolyForm-Noncommercial-1.0.0
+License-File: LICENSE
+Keywords: agent,ai,chat,cli,coding-assistant,ollama,seedcode,terminal
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Terminals
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: openai>=1.40.0
+Requires-Dist: prompt-toolkit>=3.0.43
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: rich>=13.7.0
+Provides-Extra: dev
+Requires-Dist: pytest-mock>=3.12.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Seed Code CLI
+
+**Seed Code — Eagox Studio**
+
+> ### Faster. Smaller. Smarter. Workspace-aware.
+> *Plant ideas. Grow code.*
+
+Seed Code is a premium terminal-based **AI coding agent** that runs directly
+inside your terminal. One unified agent — not a chat bot with a mode switch —
+reads your project, plans the work, writes and edits real files, runs real
+commands, reads their output, searches the web for documentation, fixes what
+fails, and reports honestly on what it actually did.
+
+`seedcode --version` → `Seed Code CLI 9.2.0`
+
+---
+
+## What you get
+
+- **One unified agent.** There are no Chat/Agent/Code modes: every request is
+  one agent turn. The engine decides from the request itself (conversation,
+  research, coding) which tools it needs, so a question does not read your
+  project and a coding task does not fetch the web unless it must.
+- **A live, honest execution view.** While the agent works you see the actual
+  operation and the actual tool results — never a fabricated progress bar:
+
+  ```text
+  You > read README.md
+
+    ℹ Analyzing the task and inspecting the workspace...
+    ⚙ Reading README.md
+    ✓ Read README.md
+    ⚙ Running python -m pytest -q
+    ✓ Tests passed · Exit code: 0
+    ⚙ Searching the web for 'python fastapi docs'
+    ✓ Searched online for 'python fastapi docs'
+    ⚙ Editing app.py
+    ✓ Updated app.py — +12/-5 lines (lines 1–18)
+      @@ -1,5 +1,6 @@
+       import sys
+      -print("old")
+      +print("new")
+  ```
+
+  Activity lines carry no `AI >` prefix: they are indented under your turn,
+  with a marker for the real state — `⚙` started, `✓` succeeded, `✗` failed,
+  `ℹ` informational. User input keeps its `You >` label.
+- **A real thinking indicator.** A small animated spinner sits beside the
+  *current operation* with a live elapsed timer, e.g. `⠹ Reading README.md……
+  · 12s`. The label is read from backend state (`state.operation`), so it says
+  what the agent is doing, not just "Working".
+- **Real file operations and diffs.** File reads, creations, updates and
+  deletions are reported with the path, the line counts, the affected line
+  range and a bounded unified-diff preview; `Ctrl+E` expands the last diff.
+- **Real terminal execution.** Commands show the command, the working
+  directory, live output, the exit code and the duration; `Ctrl+T` expands the
+  last command's full output. Windows PowerShell and POSIX shells both work.
+- **Real internet research.** When a task needs current documentation the
+  agent searches keyless and reads the pages it found; the search query, the
+  source URL and the retrieved information are surfaced as real events.
+- **A final report that matches reality.** When the turn ends you get a
+  report of the files created/modified/deleted, commands run, tests run and
+  their results — built only from operations that really happened.
+- **Permissions that are asked, not assumed.** Dangerous actions (shell
+  commands, deletes, git mutations, writes outside the workspace) ask first:
+  Allow once / Always (session) / Allow All (session) / Deny. Grants live for
+  the session only and are never written to disk.
+- **Providers and models.** Default (built in, no key), OpenRouter, FreeModel
+  Claude, FreeModel Codex, AeroLink and **Ollama** (started automatically when
+  you select it). Custom OpenAI-compatible providers can be added without
+  limit, each with its own name, base URL, key and model. Selecting a provider
+  never copies another provider's key or model, and a failed request is
+  reported rather than silently rerouted (automatic failover is opt-in).
+- **Compact, responsive header.** A two-row bar — branding, provider, model and
+  mode on the first row; live status, workspace, context budget and the masked
+  key on the second — that never clips at any terminal width.
+
+---
+
+## Installation
+
+After any installation method, `seedcode` is the primary command:
+
+```bash
+seedcode
+```
+
+### pip (any platform)
+
+```bash
+pip install seedcode-cli
+```
+
+Requires **Python 3.10 or newer**. The wheel exposes the `seedcode` console
+script; `python -m seedcode` also works as a developer fallback.
+
+### Windows — remote installer (recommended)
+
+PowerShell 5.1 or newer:
+
+```powershell
+irm https://seedcode-cli.vercel.app/install.ps1 | iex
+```
+
+Installs for the current user (no administrator rights, no Python) into
+`%LOCALAPPDATA%\Programs\SeedCode`, adds `seedcode` to your user `PATH`, and
+verifies the installed binary reports exactly the requested version. It
+downloads the official `SeedCode-CLI-9.2.0-windows-x64.exe` and the release's
+`SHA256SUMS.txt`, and **refuses to install** if the checksum entry is missing,
+the checksum file is unreachable, or the digest does not match.
+
+### Windows — Setup installer
+
+Download `SeedCode-CLI-Setup-9.2.0.exe` from the
+[Releases page](https://github.com/Alshahriar-07/seedcode-cli/releases/tag/v9.2.0)
+and run it. The wizard installs Seed Code, adds it to `PATH`, creates a Start
+Menu shortcut, verifies that the installed `seedcode.exe` reports the
+installer's own version, and ships an uninstaller that never deletes your
+project data silently.
+
+### Windows — portable executable
+
+Download `SeedCode-CLI-9.2.0-windows-x64.exe` and run it directly. It is fully
+self-contained (no Python, no installation, no `PATH` changes).
+
+### Linux / macOS — remote installer
+
+```bash
+curl -fsSL https://seedcode-cli.vercel.app/install.sh | bash
+```
+
+Installs for the current user and verifies the downloaded artifact against the
+release's `SHA256SUMS.txt` before anything is installed. This release publishes
+no prebuilt Linux/macOS binary, so the installer uses the official Python wheel
+(requires **Python 3.10+ with pip**, or pipx when available).
+
+### From source (development)
+
+```bash
+git clone https://github.com/Alshahriar-07/seedcode-cli.git
+cd seedcode-cli
+python -m pip install -e ".[dev]"
+seedcode
+```
+
+After installing by any route:
+
+```bash
+seedcode --version    # -> Seed Code CLI 9.2.0
+```
+
+> **`seedcode` not recognized?** Open a *new* terminal. `PATH` changes only
+> apply to fresh sessions; the installers verify this before they finish.
+
+---
+
+## First run
+
+On first launch Seed Code asks where it may work:
+
+```text
+  Select Workspace
+  --------------------------------------------------------------
+  Where should Seed Code work? It reads, writes, indexes and runs
+  commands only inside the folder you pick.
+
+    1  Current Folder    D:\Projects\my-site
+    2  Choose a Folder   browse this PC and pick any directory
+
+  Select [1] >
+```
+
+`Current Folder` keeps the directory you launched from; `Choose a Folder` opens
+your operating system's native folder picker. The chosen directory becomes the
+**workspace** — the single root for file reads and writes, project indexing,
+`.seedcode` project memory, terminal commands and verification. Nothing outside
+it is touched without permission.
+
+Automation is never blocked: `SEEDCODE_WORKSPACE=<dir>` selects the workspace
+directly, and `SEEDCODE_NO_WORKSPACE_PROMPT=1` (or a non-interactive host)
+keeps the launch directory.
+
+You then land in the persistent interface:
+
+```text
+Seed Code CLI v9.2.0 · Ollama · qwen3:4b · Agent
+● Ready · Workspace D:\Projects\demo · Context 16,384 tokens
+
+You > read README.md
+
+  ℹ Analyzing the task and inspecting the workspace...
+  ⚙ Reading README.md
+  ✓ Read README.md
+  ⠹ Inspecting project structure...  · 4s
+
+╭─ Message ──────────────────────────────────────────────────────────────────╮
+│ › read README.md                                                           │
+╰────────────────────────────────────────────────────────────────────────────╯
+  Enter ↵ send  ·  Shift+Enter newline  ·  / commands  ·  Ctrl+C cancel
+```
+
+The header is fixed: it never scrolls away and every value updates in place the
+moment it changes. Only the conversation scrolls; the composer stays at the
+bottom.
+
+### Composer and keys
+
+The composer is a real bounded multiline editor with no prefix of its own — the
+message you type is exactly the message that is sent.
+
+| Key | Action |
+| --- | --- |
+| `Enter` | Send the message |
+| `Shift+Enter` (or `Ctrl+J` / `Alt+Enter`) | Insert a newline without sending |
+| `↑` / `↓` | Move inside a multiline message; walk history at the edges |
+| `/` at the start of a line | Slash-command autocomplete (filter, arrows, Enter, Esc, mouse) |
+| `Ctrl+C` | Cancel the running turn (or clear the composer when idle) |
+| `Esc` | Dismiss suggestions / deny a pending permission prompt |
+| `Ctrl+E` | Expand the last file diff |
+| `Ctrl+T` | Expand the last command's output |
+| `PageUp` / `PageDown`, `Ctrl+Home` / `Ctrl+End` | Scroll the conversation |
+| Mouse wheel | Scroll the conversation |
+| `Ctrl+D` | Exit |
+
+Set `SEEDCODE_NO_TUI=1` (or `SEEDCODE_PLAIN=1`) to use the sequential console
+instead — piped hosts do this automatically.
+
+---
+
+## Providers and models
+
+| Provider | Key required | Notes |
+| --- | --- | --- |
+| **Default** | No | Seed Code's built-in connection; ships pointed at a free coding model. Also reads `OPENROUTER_API_KEY` / `SEEDCODE_DEFAULT_API_KEY` from the environment. |
+| **OpenRouter** | Yes | Bring your own OpenRouter key. |
+| **FreeModel Claude** | Yes | FreeModel backend, Claude models. |
+| **FreeModel Codex** | Yes | FreeModel backend, Codex models. |
+| **AeroLink** | Yes | AeroLink backend. |
+| **Ollama** | No | Local models. Selecting Ollama starts `ollama serve` automatically when it is not already running. |
+| **Custom** | Depends | Any OpenAI-compatible endpoint: name, base URL, key, model. |
+
+Every provider keeps its **own** key and model: switching providers never copies
+one provider's credentials or model onto another.
+
+### Ollama
+
+1. Install Ollama from <https://ollama.com> and pull a model, e.g.
+   `ollama pull qwen3:4b`.
+2. In Seed Code run `/provider` and choose **Ollama**, then `/model` and pick
+   the model you pulled.
+
+If the server is not running, Seed Code starts `ollama serve` for you and waits
+for it to become reachable. The default host is `http://localhost:11434`. A
+request that fails is reported as a failure — Seed Code never silently switches
+to a cloud provider when you selected Ollama (automatic failover is off unless
+you enable `auto_failover`).
+
+---
+
+## How a task runs
+
+1. **Your request** is classified by a deterministic, model-free classifier
+   (`seedcode/core/intent.py`): conversation, research or coding.
+2. **The engine selects tools** for that intent — filesystem, terminal, git and
+   search for coding; the web tools for research. Nothing else is offered.
+3. **Every tool call performs a real operation.** A read reads, a write writes,
+   a command runs in the workspace shell; the result (including its error) is
+   returned to the model, which continues from the real output.
+4. **The loop continues** until the task is complete or genuinely blocked —
+   bounded so it can never spin forever, streamed so the UI never freezes, and
+   cancellable at any moment with `Ctrl+C`.
+5. **A report is produced** from the operations that actually happened: files
+   created/modified/deleted, commands executed with exit codes, tests run and
+   their results, and anything still incomplete.
+
+### Project memory and sessions
+
+An active workspace gets a `.seedcode/` directory with a project index, memory
+notes and the session checkpoint. A long task is checkpointed, so `/pause`
+followed by `/resume` continues from the current task instead of starting over.
+`/session` shows the live session's plan and per-task records; `/memory` shows
+the project memory.
+
+---
+
+## Command reference
+
+Every command is real and reachable; typing `/` at the start of a line shows
+them with descriptions and filters as you type.
+
+| Command | Purpose |
+| --- | --- |
+| `/help` | Show available commands |
+| `/status` | Show the live runtime status |
+| `/provider` | Select the active provider |
+| `/model` | Browse and select a model for the active provider |
+| `/custom` | Manage custom providers (add, edit, test, reorder, enable, delete) |
+| `/apikey` | View, replace, remove, or validate the active provider's key |
+| `/workspace` | Show the active project, or select a different folder |
+| `/permission` | Show or set the tool permission level (alias `/permissions`) |
+| `/session` | Show agent session state and per-task records |
+| `/pause` / `/resume` / `/stop` | Pause, resume or stop the running agent session |
+| `/memory` | Show the `.seedcode` project memory and recent session notes |
+| `/index` | Show a compact tree of the current project |
+| `/files` | Search project files (`Ctrl+P`) |
+| `/tools` | List the tools available to the coding agent |
+| `/history` | Browse the active provider's saved sessions |
+| `/doctor` | Diagnose configuration, network and provider health |
+| `/settings` | Open interactive settings (or `/settings <name> <value>`) |
+| `/theme` | Pick a colour theme |
+| `/palette` | Open the command palette (`Ctrl+K`) |
+| `/shortcuts` | Show keyboard shortcuts |
+| `/reset` | Forget the current conversation context |
+| `/clear` | Clear the screen |
+| `/config` | Show the current configuration |
+| `/about` / `/version` | About / version |
+| `/exit` | Leave the session (back to the main menu) |
+
+Aliases: `quit`, `q`, `menu` → `/exit`; `keys` → `/shortcuts`; `commands` →
+`/palette`; `search` → `/files`; `providers`/`custom-providers` → `/custom`;
+`key` → `/apikey`; `project`/`folder`/`ws` → `/workspace`; `perm` →
+`/permission`.
+
+---
+
+## Permissions
+
+Seed Code uses a single hierarchical permission level:
+
+| Level | May do |
+| --- | --- |
+| `read_only` | Inspect only: no writes, no commands, no git mutations. |
+| `workspace` | Read anywhere, mutate only inside the workspace (the default). |
+| `full_system` | No path restriction on mutations (still confirmed per action). |
+
+On top of the level, *dangerous* actions ask for confirmation: shell commands,
+file deletes, git mutations and writes outside the workspace. Answers are
+`Allow once`, `Always` (this category, this session), `Allow All` (everything,
+this session) or `Deny`. Nothing is persisted; a denial is reported to the
+model as a real tool failure, not hidden.
+
+Set the level with `/permission workspace` (or `read_only`, `full_system`).
+
+---
+
+## Internet access
+
+Research requests can search and read current sources keylessly: a DuckDuckGo
+HTML search, page fetching with boilerplate stripped, and a
+character-budgeted, URL-attributed context block. Every failure degrades to
+"no results" instead of crashing the turn. Set
+`SEEDCODE_DISABLE_INTERNET=1` to turn it off for a session, and
+`SEEDCODE_MAX_RETRIES` to bound provider retries.
+
+---
+
+## Configuration and local data
+
+```text
+~/.seedcode/
+├── config.json       provider and application settings
+├── history/          saved conversation sessions (per provider)
+├── memory/           persistent local memory
+└── logs/             rotating diagnostic logs
+```
+
+`config.json` keeps one isolated entry per provider. Upgrades preserve it: your
+settings, keys and history live outside the install directory and are never
+deleted by an installer. `default_api`/`OPENROUTER_API_KEY` environment
+variables are honoured for the Default provider.
+
+Environment variables: `SEEDCODE_WORKSPACE`, `SEEDCODE_NO_WORKSPACE_PROMPT`,
+`SEEDCODE_NO_TUI`, `SEEDCODE_PLAIN`, `SEEDCODE_PROVIDER`, `SEEDCODE_MODEL`,
+`SEEDCODE_SHELL`, `SEEDCODE_DISABLE_INTERNET`, `SEEDCODE_MAX_RETRIES`,
+`SEEDCODE_DIRNAME`, `SEEDCODE_DEBUG`, `SEEDCODE_DISABLE_DOTENV`,
+`SEEDCODE_DOTENV`, `SEEDCODE_DEFAULT_API_KEY`, `OPENROUTER_API_KEY`.
+
+---
+
+## Building from source
+
+### Python distributions
+
+```bash
+python -m pip install build twine
+python -m build                     # dist/seedcode_cli-9.2.0-*.whl and *.tar.gz
+python -m twine check dist/*
+```
+
+### Windows executable + installer
+
+```bat
+scripts\windows\build.bat
+```
+
+The pipeline runs the test suite as a release gate, builds the standalone
+`dist\seedcode.exe` with PyInstaller (icon and version resource embedded,
+`--version` verified against the source version), compiles the Inno Setup
+installer, and stages the release directory with real SHA-256 checksums.
+Requirements: Python 3.10+, PyInstaller, Inno Setup 6 or 7.
+
+---
+
+## Release artifacts (v9.2.0)
+
+Release: [v9.2.0](https://github.com/Alshahriar-07/seedcode-cli/releases/tag/v9.2.0)
+
+| File | What it is |
+| --- | --- |
+| `SeedCode-CLI-Setup-9.2.0.exe` | Windows Setup installer (Inno Setup; uninstaller, Start Menu entry). |
+| `SeedCode-CLI-9.2.0-windows-x64.exe` | Standalone Windows executable — downloaded by the Windows IRM installer. |
+| `seedcode_cli-9.2.0-py3-none-any.whl` | Python wheel — downloaded by the Linux IRM installer. |
+| `seedcode_cli-9.2.0.tar.gz` | Python source distribution. |
+| `seedcode-cli-9.2.0.tgz` | npm package tarball (launcher that downloads the official binary). |
+| `SHA256SUMS.txt` | SHA-256 of every artifact above. |
+
+Verify a download before using it:
+
+```bash
+sha256sum -c SHA256SUMS.txt              # Linux / macOS
+Get-FileHash <file> -Algorithm SHA256    # Windows PowerShell
+```
+
+All release artifacts are staged in `dist/release/9.2.0/` by the build pipeline;
+digests are computed from the final files, never copied from an older release.
+
+---
+
+## Troubleshooting
+
+| Symptom | Fix |
+| --- | --- |
+| `seedcode` not found after install | Open a new terminal (`PATH` applies to new sessions). |
+| "No model selected" | Run `/model` (and `/provider` first if needed). |
+| Ollama errors | Make sure Ollama is installed; Seed Code starts `ollama serve` automatically. `ollama list` shows pulled models. |
+| Provider needs a key | `/apikey` for the active provider, or `/provider` to switch. |
+| A command was blocked | Approve it at the permission prompt, or set `/permission full_system` for path-unrestricted writes. |
+| Diagnostics | `/doctor` reports configuration, connection and provider health. |
+| Corporate proxy / offline | Set `SEEDCODE_DISABLE_INTERNET=1`; cloud providers still need network access. |
+
+Logs live in `~/.seedcode/logs/`.
+
+---
+
+## Security model
+
+- API keys are stored in your user configuration directory, never in the repo,
+  never in shell history, and are always masked in the UI (`sk-or-v1...e031`).
+- The workspace boundary is enforced by the permission manager, not by prompt
+  wording: tools ask before any privileged operation.
+- Release installers verify SHA-256 against the published `SHA256SUMS.txt` and
+  abort on a missing entry or a mismatch; verification is never bypassed.
+
+---
+
+## Credits
+
+Built by **Al Shahriar Sowan** (Eagox Studio).
+
+## License
+
+PolyForm Noncommercial License 1.0.0 — see [LICENSE](LICENSE).