mycode-cli 0.1.0__tar.gz

mycode_cli-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/mycode-cli/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Install Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20
+          cache: pnpm
+          cache-dependency-path: frontend/pnpm-lock.yaml
+
+      - name: Install Python
+        run: uv python install 3.12
+
+      - name: Build
+        run: uv build --no-sources
+
+      - name: Verify wheel import
+        run: uv run --isolated --no-project --with dist/*.whl -- python -c "import mycode"
+
+      - name: Publish to PyPI
+        run: uv publish

mycode_cli-0.1.0/.gitignore

@@ -0,0 +1,88 @@
+# OS specific
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# IDEs and Editors
+.vscode/
+!.vscode/extensions.json
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Environment
+.env
+.env.local
+.env.*.local
+*.local
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.venv/
+venv/
+env/
+ENV/
+.python-version
+*.egg-info/
+dist-python/
+build/
+*.egg
+.uv-cache
+
+# Node.js / Frontend
+node_modules/
+dist/
+dist-ssr/
+.vite/
+*.tsbuildinfo
+.eslintcache
+.npm
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Archives
+archive/
+legacy/
+
+# Local data
+/mycode/server/static/
+
+# Config with secrets (use config.example.json as template)
+config.json
+
+# AI Agents
+CLAUDE.md
+.claude/
+GEMINI.md
+.gemini/
+.pi/

mycode_cli-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,30 @@
+# See https://pre-commit.com for more information
+repos:
+  # General hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: ["--maxkb=1000"]
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  # Python - Ruff (linter + formatter)
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.13
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+
+  # Frontend - Biome (linter + formatter)
+  - repo: https://github.com/biomejs/pre-commit
+    rev: v2.4.7
+    hooks:
+      - id: biome-check
+        additional_dependencies: ["@biomejs/biome@2.4.7"]
+        args: ["--config-path=biome.json"]
+        files: ^frontend/

mycode_cli-0.1.0/AGENTS.md

@@ -0,0 +1,190 @@
+# mycode — Project Context
+
+Authoritative context for agent runs. Keep in sync with the code. See `docs/` for detailed specs.
+
+## Product
+
+`mycode` is a personal minimal coding agent with a web UI and CLI.
+
+Priorities: small readable core · one message model · one agent loop · append-only sessions · provider adapters at the boundary.
+
+Not a general agent framework.
+
+## Core Rules
+
+- 4 built-in tools only: `read`, `write`, `edit`, `bash` — do not add more to core
+- Provider-specific behavior stays inside adapters, never in the agent loop
+- Prefer simple Python; add helpers only for real reuse or non-obvious logic
+- Keep the runtime deterministic and easy to inspect
+
+## Source Map
+
+Core runtime (`mycode/core/`):
+
+- `agent.py` — the only orchestration loop
+- `messages.py` — internal message/block format
+- `tools.py` — 4 built-in tools, executor, truncation, path resolution
+- `session.py` — append-only JSONL session storage, compact/rewind events, interrupted tool repair
+- `config.py` — layered config loading and provider resolution
+- `models.py` — bundled model metadata lookup (`context_window`, `supports_reasoning`, `supports_image_input`)
+- `system_prompt.py` — runtime system prompt assembly, AGENTS.md discovery, skills discovery
+- `system_prompt.md` — system prompt template
+- `providers/base.py` — ProviderAdapter abstract interface
+- `providers/__init__.py` — adapter registry and provider lookup helpers
+- `providers/anthropic_like.py` — adapters: `anthropic`, `moonshotai`, `minimax`
+- `providers/gemini.py` — adapter: `google`
+- `providers/openai_responses.py` — adapter: `openai`
+- `providers/openai_chat.py` — adapters: `openai_chat`, `deepseek`, `zai`, `openrouter`
+
+CLI (`mycode/cli/`):
+
+- `main.py` — Typer entrypoint (commands: default, run, web, session)
+- `chat.py` — TerminalChat interactive loop
+- `render.py` — TerminalView rich rendering
+- `runtime.py` — build_agent(), resolve_session()
+
+Server (`mycode/server/`):
+
+- `app.py` — FastAPI factory, static mount
+- `routers/chat.py` — POST /api/chat, GET /api/runs/{id}/stream, POST /api/runs/{id}/cancel, GET /api/config
+- `routers/sessions.py` — session CRUD
+- `routers/workspaces.py` — directory browser
+- `run_manager.py` — concurrent run management
+- `schemas.py` — Pydantic request/response models
+
+Frontend (`frontend/src/`):
+
+- `hooks/useChat.ts` — chat state, SSE streaming, tool runtime
+- `utils/messages.ts` — buildRenderMessages() — canonical blocks → UI messages
+
+## Internal Message Model
+
+Block-based JSON — single format used at runtime and persisted to sessions:
+
+```json
+{
+  "role": "assistant",
+  "content": [
+    {"type": "thinking", "text": "...", "meta": {}},
+    {"type": "text", "text": "..."},
+    {"type": "tool_use", "id": "call_1", "name": "read", "input": {"path": "x.py"}}
+  ],
+  "meta": {
+    "provider": "anthropic",
+    "model": "claude-sonnet-4-6",
+    "stop_reason": "tool_use",
+    "usage": {},
+    "native": {}
+  }
+}
+```
+
+Block types: `text` · `image` · `thinking` · `tool_use` · `tool_result`
+
+- `thinking` blocks are first-class session data — persisted and shown in UI
+- Provider-specific extras: `meta.native` on messages, `block.meta.native` on blocks
+- Tool results stored as a `user` message with `tool_result` blocks:
+
+  ```json
+  {"type": "tool_result", "tool_use_id": "call_1", "model_text": "ok", "display_text": "Wrote x.py", "is_error": false}
+  ```
+
+  `model_text` is replayed to providers on later turns; `display_text` is shown to users.
+  `tool_result.content` may store structured `text` and `image` blocks.
+- System prompt is runtime-only, not persisted
+
+## Agent Loop
+
+`mycode/core/agent.py` — per user turn:
+
+1. Append user message to session
+2. Call provider adapter → stream events to CLI/server
+3. Persist assistant message to JSONL
+4. Execute tool calls locally
+5. Append `user` tool-result message
+6. Repeat until no tool calls; `max_turns` defaults to unlimited
+7. Optionally compact context when usage ≥ `compact_threshold` (default 0.8)
+
+## Provider Adapters
+
+See `docs/providers.md` for per-adapter details, env vars, and quirks.
+
+| id            | protocol                      | file                  |
+| ------------- | ----------------------------- | --------------------- |
+| `anthropic`   | Anthropic Messages API        | `anthropic_like.py`   |
+| `moonshotai`  | Anthropic-compatible endpoint | `anthropic_like.py`   |
+| `minimax`     | Anthropic-compatible endpoint | `anthropic_like.py`   |
+| `google`      | Google genai SDK              | `gemini.py`           |
+| `openai`      | OpenAI Responses API          | `openai_responses.py` |
+| `openai_chat` | OpenAI Chat Completions       | `openai_chat.py`      |
+| `deepseek`    | OpenAI-compatible chat        | `openai_chat.py`      |
+| `zai`         | OpenAI-compatible chat        | `openai_chat.py`      |
+| `openrouter`  | OpenAI-compatible chat        | `openai_chat.py`      |
+
+All adapters implement `ProviderAdapter.stream_turn()`. Message projection to provider wire format lives in `prepare_messages()`.
+
+## SSE Contract
+
+**Do not change event names or payload shapes without updating server, CLI, and frontend.**
+
+| event         | payload                                                 |
+| ------------- | ------------------------------------------------------- |
+| `reasoning`   | `delta`                                                 |
+| `text`        | `delta`                                                 |
+| `tool_start`  | `tool_call: {id, name, input}`                          |
+| `tool_output` | `tool_use_id`, `output`                                 |
+| `tool_done`   | `tool_use_id`, `model_text`, `display_text`, `is_error` |
+| `compact`     | `message`                                               |
+| `error`       | `message`                                               |
+
+## Detailed Docs
+
+- `docs/api.md` — Server API endpoints, request/response schemas, SSE contract details
+- `docs/config.md` — Config files, schema, API key resolution, reasoning effort, skills/instructions discovery
+- `docs/providers.md` — Per-adapter details: SDK, base URL, env vars, reasoning effort mapping, quirks
+- `docs/sessions.md` — Storage layout, JSONL record types, compact/rewind/repair, format version
+- `docs/frontend.md` — Component structure, message state model, build process
+
+## Interfaces
+
+**CLI** — `mycode/cli/main.py`:
+
+- `mycode` — interactive session (default)
+- `mycode run "..."` — non-interactive single run
+- `mycode web [--dev]` — web server; `--dev` serves API only (for Vite dev)
+- `mycode session list` — list sessions
+- Interactive CLI: `@path` attaches files; images become `image` blocks, text files become extra `text` blocks
+- Slash commands: `/clear` `/new` `/resume` `/rewind` `/provider` `/model` `/effort` `/q`
+
+**Server** — `mycode/server/routers/`:
+
+- `POST /api/chat` — start a run from `message` or `input`; returns `{run, session}` JSON immediately
+- `GET /api/runs/{run_id}/stream` — SSE stream for a run
+- `POST /api/runs/{run_id}/cancel` — cancel a run
+- `GET /api/config` — provider, reasoning, and image-input metadata for frontend
+- Session CRUD at `/api/sessions`
+- Workspace browser at `/api/workspaces`
+
+## Dev Workflow
+
+```bash
+uv sync --dev                                          # Python setup
+uv run mycode                                          # run CLI
+uv run mycode web --dev                                # API only (backend for Vite dev)
+pnpm --dir frontend test:run                           # run frontend tests once
+pnpm --dir frontend dev                                # Vite frontend dev server
+uv run --no-project python scripts/build_frontend.py  # rebuild packaged frontend
+uv build                                               # build wheel + sdist
+```
+
+## Guardrails
+
+Preserve unless explicitly asked to change:
+
+- 4-tool core stays unchanged
+- Append-only sessions stay human-inspectable
+- CLI and server remain thin wrappers over `mycode.core`
+- Provider-specific quirks stay in adapters
+- No new abstraction layers unless they remove real complexity
+
+When in doubt, prefer the simpler and more explicit design.

mycode_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LeGibet
+
+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.

mycode_cli-0.1.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: mycode-cli
+Version: 0.1.0
+Summary: Minimal coding agent with web UI
+Project-URL: Homepage, https://github.com/legibet/mycode
+Project-URL: Repository, https://github.com/legibet/mycode
+Project-URL: Issues, https://github.com/legibet/mycode/issues
+Author-email: LeGibet <legibetpeng@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent,cli,coding-agent,fastapi,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.12
+Requires-Dist: anthropic>=0.74.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: google-genai>=1.68.0
+Requires-Dist: openai>=2.11.0
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: rich>=14.2.0
+Requires-Dist: typer>=0.24.1
+Requires-Dist: uvicorn[standard]>=0.32.0
+Description-Content-Type: text/markdown
+
+# mycode
+
+>There are many coding agents, but this one is mine.
+
+A minimal coding agent. Inspired by [pi](https://github.com/badlogic/pi-mono).
+
+- Minimal core (under 5k lines of code).
+- Unified message format and robust cross-provider replay.
+- 4 built-in tools: `read`, `write`, `edit`, `bash`, expanded via skills.
+- Inspectable runtime, append-only JSONL sessions.
+- Native image input.
+- Mobile-friendly web UI.
+
+## Quick Start
+
+Requires Python 3.12+. Install via [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv tool install mycode-cli
+```
+
+Interactive terminal session:
+
+```bash
+mycode
+```
+
+Web UI (default at `http://localhost:8000`):
+
+```bash
+mycode web (--port <port> --hostname <hostname>)
+```
+
+Single message, non-interactive:
+
+```bash
+mycode run "explain how the session store works"
+```
+
+API keys are discovered automatically from environment variables (see Providers & Models).
+
+## Providers & Models
+
+| Provider          | id            | Env var              | Default models                                     |
+| ----------------- | ------------- | -------------------- | -------------------------------------------------- |
+| Anthropic         | `anthropic`   | `ANTHROPIC_API_KEY`  | `claude-sonnet-4-6`, `claude-opus-4-6`             |
+| OpenAI            | `openai`      | `OPENAI_API_KEY`     | `gpt-5.4`, `gpt-5.4-mini`                          |
+| Google Gemini     | `google`      | `GEMINI_API_KEY`     | `gemini-3.1-pro-preview`, `gemini-3-flash-preview` |
+| Moonshot          | `moonshotai`  | `MOONSHOT_API_KEY`   | `kimi-k2.5`                                        |
+| MiniMax           | `minimax`     | `MINIMAX_API_KEY`    | `MiniMax-M2.7`, `MiniMax-M2.7-highspeed`           |
+| DeepSeek          | `deepseek`    | `DEEPSEEK_API_KEY`   | `deepseek-chat`, `deepseek-reasoner`               |
+| Z.AI              | `zai`         | `ZAI_API_KEY`        | `glm-5.1`, `glm-5-turbo`                           |
+| OpenRouter        | `openrouter`  | `OPENROUTER_API_KEY` | `openrouter/auto`                                  |
+| OpenAI-compatible | `openai_chat` | —                    | (configured per provider)                          |
+
+## Configuration
+
+No config file is required. It is only used for:
+
+1. Setting default provider, model, and other options
+2. Overriding built-in provider settings (e.g. changing the available model list)
+3. Adding custom providers with any built-in provider type.
+4. Customize model metadata for built-in and custom models.
+
+Config is loaded from `~/.mycode/config.json` (global) and `<workspace>/.mycode/config.json` (project-specific, takes precedence).
+
+```json
+{
+  "default": {
+    "provider": "anthropic",
+    "model": "claude-sonnet-4-6",
+    "reasoning_effort": "medium"
+  },
+  "providers": {
+    "openrouter": {
+      "models": {
+        "deepseek/deepseek-v3.2": {},
+        "xiaomi/mimo-v2-pro": {}
+      }
+    },
+    "zhipu-coding-plan": {
+      "type": "zai",
+      "base_url": "https://open.bigmodel.cn/api/coding/paas/v4",
+      "api_key": "${ZHIPU_API_KEY}"
+    },
+    "custom-provider": {
+      "type": "openai_chat",
+      "base_url": "https://custom-endpoint.com/v1",
+      "api_key": "${CUSTOM_API_KEY}",
+      "models": {
+        "custom-model": {
+          "context_window": 128000,
+          "max_output_tokens": 16384,
+          "supports_reasoning": true,
+          "supports_image_input": false
+        }
+      }
+    }
+  }
+}
+```
+
+- Built-in provider ids can be overridden by key without specifying `type`. Custom providers must set `type`.
+- `reasoning_effort` controls extended thinking for supported models: `auto` (default) · `none` · `low` · `medium` · `high` · `xhigh`.
+- API keys in config accept `${ENV_VAR}` references.
+- Model metadata is sourced from models.dev and bundled — no manual config needed for built-in models.
+
+> Built-in Moonshot, MiniMax, and Z.AI defaults use international endpoints. Override `base_url` in config for China endpoints.
+
+## CLI Reference
+
+```
+mycode                            start interactive session (new)
+mycode --continue                 resume the most recent session
+mycode --session <id>             resume a specific session
+mycode run "..."                  send one message, non-interactive
+mycode web                        start web server (default port 8000)
+mycode web --dev                  API only, no static files
+mycode session list               list saved sessions
+```
+
+Interactive slash commands: `/new` `/resume` `/provider` `/model` `/effort` `/clear` `/q`
+
+## Development
+
+```bash
+git clone <repo> && cd mycode
+uv sync --dev
+uv run mycode
+```
+
+Web development (backend + Vite dev server):
+
+```bash
+uv run mycode web --dev
+pnpm --dir frontend install && pnpm --dir frontend dev
+```
+
+Rebuild packaged frontend assets:
+
+```bash
+uv run --no-project python scripts/build_frontend.py
+```
+
+Build distributable artifacts:
+
+```bash
+uv build
+```
+
+## License
+
+MIT