closecode 0.1.0__py3-none-any.whl

closecode/ui/widgets/composer.py

@@ -0,0 +1,52 @@
+"""Close Code Composer widget — message input with send button."""
+
+from textual.app import ComposeResult
+from textual.widget import Widget
+from textual.widgets import Input, Button
+from textual.containers import Horizontal
+from textual.message import Message
+
+
+class ComposerSubmit(Message):
+    """Posted when the user submits a message (Enter or Send button)."""
+    def __init__(self, text: str):
+        self.text = text
+        super().__init__()
+
+
+class CloseCodeComposer(Widget):
+    """Message input with Enter to send and a Send button."""
+
+    def compose(self) -> ComposeResult:
+        with Horizontal(id="composer-container"):
+            yield Input(
+                placeholder="Type a message or /help…",
+                id="composer-input",
+            )
+            yield Button("↑", id="composer-send", variant="primary")
+
+    def on_mount(self):
+        self.query_one("#composer-input", Input).focus()
+
+    def on_input_submitted(self, event: Input.Submitted):
+        """Handle Enter key in the input."""
+        text = event.value.strip()
+        if text:
+            self.post_message(ComposerSubmit(text))
+            event.input.value = ""
+
+    def on_button_pressed(self, event: Button.Pressed):
+        """Handle send button click."""
+        if event.button.id == "composer-send":
+            inp = self.query_one("#composer-input", Input)
+            text = inp.value.strip()
+            if text:
+                self.post_message(ComposerSubmit(text))
+                inp.value = ""
+            inp.focus()
+
+    def clear(self):
+        self.query_one("#composer-input", Input).value = ""
+
+    def set_focus(self):
+        self.query_one("#composer-input", Input).focus()

closecode/ui/widgets/header.py

@@ -0,0 +1,53 @@
+"""Close Code Header widget — top bar with title, model, and connection status."""
+
+from textual.app import ComposeResult
+from textual.widget import Widget
+from textual.widgets import Static
+
+from closecode.agent import AgentState
+
+
+class CloseCodeHeader(Widget):
+    """Top bar: Close Code title + model + connection indicator."""
+
+    DEFAULT_CSS = ""
+
+    def __init__(self, connected: bool = False):
+        super().__init__()
+        self._connected = connected
+
+    def compose(self) -> ComposeResult:
+        with Static(id="header-bar"):
+            yield Static("⬡ Close Code", id="header-title")
+            yield Static("", id="header-model")
+            yield Static("", id="header-spacer")
+            yield Static("", id="header-connection")
+
+    def update_state(self, state: AgentState):
+        """Update header from agent state."""
+        # Model
+        model = self.query_one("#header-model", Static)
+        if state.model:
+            name = state.model
+            if "/" in name:
+                name = name.split("/", 1)[1]
+            if ":free" in name:
+                name = name.replace(":free", " ·free")
+            model.update(f"  [{name}]")
+        else:
+            model.update("")
+
+        # Connection
+        self.set_connected(state.connected)
+
+    def set_connected(self, connected: bool):
+        self._connected = connected
+        conn = self.query_one("#header-connection", Static)
+        if connected:
+            conn.update("● Connected")
+            conn.set_class(True, "status-connected")
+            conn.set_class(False, "status-disconnected")
+        else:
+            conn.update("○ Disconnected")
+            conn.set_class(False, "status-connected")
+            conn.set_class(True, "status-disconnected")

closecode/ui/widgets/infopanel.py

@@ -0,0 +1,101 @@
+"""Close Code Info Panel — right sidebar showing tokens, context, and task checklist."""
+
+from textual.app import ComposeResult
+from textual.widget import Widget
+from textual.widgets import Static
+from textual.containers import Vertical, VerticalScroll
+
+from closecode.agent import AgentState, AgentStatus
+
+
+class TaskItem(Static):
+    """A single task in the checklist."""
+    pass
+
+
+class CloseCodeInfoPanel(Widget):
+    """Right sidebar: tokens, context %, model status, task checklist.
+
+    Takes 1/5 of the horizontal space (4:1 ratio with chat).
+    """
+
+    def __init__(self):
+        super().__init__()
+        self._tasks: list[tuple[str, bool]] = []  # (label, done)
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="info-panel-inner"):
+            # Stats section
+            yield Static("📊 Stats", id="info-header", classes="info-section-title")
+            yield Static("Tokens: 0", id="info-tokens", classes="info-stat")
+            yield Static("Context: 0%", id="info-context", classes="info-stat")
+            yield Static("", id="info-model-status", classes="info-stat")
+
+            # Divider
+            yield Static("─" * 20, classes="info-divider")
+
+            # Tasks section
+            yield Static("📋 Tasks", id="info-tasks-header", classes="info-section-title")
+            yield VerticalScroll(id="info-tasks-list")
+
+    def update_state(self, state: AgentState, model_status_tag: str = ""):
+        """Update stats from agent state."""
+        try:
+            # Tokens
+            self.query_one("#info-tokens", Static).update(
+                f"Tokens: {state.context_used:,}"
+            )
+
+            # Context percentage
+            if state.context_total > 0:
+                pct = min(100, int(state.context_used / state.context_total * 100))
+                bar_len = 12
+                filled = int(bar_len * pct / 100)
+                bar = "█" * filled + "░" * (bar_len - filled)
+                color = "#22c55e" if pct < 50 else "#f59e0b" if pct < 80 else "#ef4444"
+                self.query_one("#info-context", Static).update(
+                    f"Context: {pct}%\n[{color}]{bar}[/]"
+                )
+            else:
+                self.query_one("#info-context", Static).update("Context: —")
+
+            # Model status tag
+            ms = self.query_one("#info-model-status", Static)
+            if model_status_tag:
+                ms.update(model_status_tag)
+            elif state.status == AgentStatus.STREAMING:
+                ms.update("[#00f5d4]● Streaming…[/]")
+            elif state.connected:
+                ms.update("[#22c55e]● Ready[/]")
+            else:
+                ms.update("[#ef4444]○ Disconnected[/]")
+        except Exception:
+            pass
+
+    def set_tasks(self, tasks: list[tuple[str, bool]]):
+        """Set the task checklist. tasks = [(label, done), ...]"""
+        self._tasks = tasks
+        try:
+            container = self.query_one("#info-tasks-list", VerticalScroll)
+            # Clear existing
+            for child in list(container.children):
+                child.remove()
+            # Add new
+            for label, done in tasks:
+                icon = "[#22c55e]✓[/]" if done else "[#71717a]○[/]"
+                style = "info-task-done" if done else "info-task-pending"
+                container.mount(TaskItem(f"{icon} {label}", classes=f"info-task {style}"))
+        except Exception:
+            pass
+
+    def add_task(self, label: str, done: bool = False):
+        """Add a task to the checklist."""
+        self._tasks.append((label, done))
+        self.set_tasks(self._tasks)
+
+    def mark_task_done(self, index: int):
+        """Mark a task as done by index."""
+        if 0 <= index < len(self._tasks):
+            label, _ = self._tasks[index]
+            self._tasks[index] = (label, True)
+            self.set_tasks(self._tasks)

closecode/ui/widgets/statusbar.py

@@ -0,0 +1,60 @@
+"""Close Code Status Bar widget — bottom bar with session, model, connection status."""
+
+from textual.app import ComposeResult
+from textual.widget import Widget
+from textual.widgets import Static
+
+from closecode.agent import AgentState, AgentStatus
+
+
+class CloseCodeStatusBar(Widget):
+    """Bottom status bar showing live application state."""
+
+    def compose(self) -> ComposeResult:
+        with Static(id="statusbar-content"):
+            yield Static("", id="sb-session", classes="status-item status-session")
+            yield Static("│", classes="status-item status-sep")
+            yield Static("No model", id="sb-model", classes="status-item status-model")
+            yield Static("│", classes="status-item status-sep")
+            yield Static("● Connected", id="sb-conn", classes="status-item status-connected")
+            yield Static("│", classes="status-item status-sep")
+            yield Static("", id="sb-status", classes="status-item")
+
+    def update_state(self, state: AgentState, session_title: str = ""):
+        """Update status bar from agent state."""
+        # Session
+        session_w = self.query_one("#sb-session", Static)
+        if session_title:
+            label = session_title if len(session_title) <= 25 else session_title[:22] + "…"
+            session_w.update(f"📋 {label}")
+        else:
+            session_w.update("")
+
+        # Model
+        model_name = state.model or "No model"
+        # Shorten for display
+        if "/" in model_name:
+            model_name = model_name.split("/", 1)[1]
+        if ":free" in model_name:
+            model_name = model_name.replace(":free", "")
+        self.query_one("#sb-model", Static).update(model_name)
+
+        # Connection
+        conn = self.query_one("#sb-conn", Static)
+        if state.connected:
+            conn.update("● Connected")
+            conn.set_class(True, "status-connected")
+            conn.set_class(False, "status-disconnected")
+        else:
+            conn.update("○ Disconnected")
+            conn.set_class(False, "status-connected")
+            conn.set_class(True, "status-disconnected")
+
+        # Streaming status
+        status_widget = self.query_one("#sb-status", Static)
+        if state.status == AgentStatus.STREAMING:
+            status_widget.update("● Streaming…")
+        elif state.status == AgentStatus.FAILED:
+            status_widget.update("✗ Error")
+        else:
+            status_widget.update("")

closecode-0.1.0.dist-info/METADATA

@@ -0,0 +1,404 @@
+Metadata-Version: 2.4
+Name: closecode
+Version: 0.1.0
+Summary: Close Code — a terminal-native AI coding agent powered by the LLMesh gateway.
+Author-email: Dhanu Gupta <dhanugupta.dev@gmail.com>
+Maintainer-email: Dhanu Gupta <dhanugupta.dev@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Dhanugupta0/LLMesh
+Project-URL: Repository, https://github.com/Dhanugupta0/LLMesh
+Project-URL: Issues, https://github.com/Dhanugupta0/LLMesh/issues
+Project-URL: Changelog, https://github.com/Dhanugupta0/LLMesh/releases
+Keywords: ai,llm,agent,cli,tui,terminal,coding-assistant,openai,groq,openrouter,nvidia-nim,llmesh
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Code Generators
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.80.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: tiktoken>=0.7.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Requires-Dist: textual-dev>=1.5.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+# ⬡ Close Code × LLMesh
+
+**A terminal-native AI coding agent, and the universal LLM gateway behind it.**
+
+[![PyPI](https://img.shields.io/pypi/v/closecode.svg?color=00f5d4&label=closecode)](https://pypi.org/project/closecode/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Deploy to Render](https://img.shields.io/badge/deploy-Render-46E3B7.svg)](https://render.com/deploy)
+
+```
+pip install closecode
+```
+
+</div>
+
+---
+
+This repository holds two halves of one system:
+
+| | What it is | How you get it |
+| :-- | :-- | :-- |
+| **⬡ Close Code** | A Textual TUI that lives in your terminal. Streaming chat, local session history, model switching. | `pip install closecode` |
+| **🌐 LLMesh** | A stateless FastAPI gateway that fans requests out to OpenAI, Groq, NVIDIA NIM and OpenRouter behind one OpenAI-compatible API. | Deploy to [Render](#-deploying-llmesh-to-render), Docker, or run locally |
+
+Close Code never talks to a provider directly. It holds one LLMesh key, and LLMesh holds the upstream keys — so provider credentials stay on the server and your prompts stay off disk anywhere but your own machine.
+
+> 📘 **Shipping it?** [`DEPLOYMENT.md`](DEPLOYMENT.md) is the step-by-step guide for deploying the gateway to Render + Neon and publishing the client to PyPI, with a pre-flight checklist and troubleshooting table.
+
+---
+
+## ✨ Features
+
+### ⬡ Close Code (terminal client)
+
+- **4:1 chat layout** — a Textual interface with message bubbles, a welcome screen, and an info sidebar.
+- **100% local sessions** — conversations are written to `~/.closecode/sessions/` as JSON. History never leaves your machine.
+- **Model status probing** — validates keys in the background and tags each model (`● Key Valid`, `⚠ Rate Limited`, `✗ API Key Invalid`).
+- **Slash commands** — `/models`, `/session N`, `/rename`, `/new`, and more.
+- **Task extraction** — parses your prompts into a live checklist in the sidebar.
+
+### 🌐 LLMesh (gateway)
+
+- **One API, many providers** — OpenAI-compatible `/v1/chat/completions`, `/v1/completions` and `/v1/embeddings` routed to whichever upstream serves the requested model.
+- **Stateless by design** — prompts and responses are proxied, never persisted.
+- **Postgres or SQLite** — point it at Neon (or any managed Postgres) with one environment variable; falls back to a local SQLite file with zero configuration.
+- **Usage accounting** — per-key token quotas, batched writes, circuit breakers on failing upstreams.
+- **Admin dashboard** — manage upstream keys, models and quotas from the web UI.
+
+---
+
+## 🏗️ Architecture
+
+Close Code owns the UI, context window and session storage. LLMesh owns routing, auth and accounting.
+
+```mermaid
+graph TD
+    subgraph Local["Your machine"]
+        O["⬡ Close Code TUI"]
+        S[("~/.closecode/sessions/<br/>local JSON")]
+        O <-->|reads / writes| S
+    end
+
+    subgraph Gateway["LLMesh gateway"]
+        L["FastAPI server<br/>:8087 or Render"]
+        DB[("Neon Postgres<br/>keys · models · usage")]
+        L <-->|config + quotas| DB
+    end
+
+    subgraph Up["Upstream providers"]
+        N["NVIDIA NIM"]
+        G["Groq"]
+        OR["OpenRouter"]
+    end
+
+    O -->|"POST /v1/chat/completions<br/>Authorization: Bearer &lt;LLMesh key&gt;"| L
+    L -->|"+ upstream key"| N
+    L -->|"+ upstream key"| G
+    L -->|"+ upstream key"| OR
+
+    N -->|SSE| L
+    G -->|SSE| L
+    OR -->|SSE| L
+    L -->|SSE passthrough| O
+```
+
+**Request lifecycle**
+
+1. You type a prompt into Close Code.
+2. Close Code reads the local session file, assembles the message history, and estimates token usage.
+3. It POSTs an OpenAI-compatible payload to LLMesh.
+4. LLMesh looks up the model, checks your key's quota, attaches the upstream provider key, and forwards.
+5. Tokens stream back over SSE, straight through LLMesh to your terminal.
+6. On completion, Close Code saves the new state to `~/.closecode/sessions/`, and LLMesh records token usage against your key.
+
+---
+
+## 🚀 Quick start
+
+### 1. Install the client
+
+```bash
+pip install closecode
+```
+
+> Prefer an isolated install? `pipx install closecode` works too.
+
+### 2. Point it at a gateway
+
+You need a running LLMesh instance and an API key from its dashboard. Either [deploy your own](#-deploying-llmesh-to-render) or [run one locally](#running-llmesh-locally).
+
+### 3. Launch
+
+```bash
+closecode
+```
+
+On first run you get an onboarding screen:
+
+1. Enter your LLMesh endpoint — `http://localhost:8087` locally, or `https://your-service.onrender.com` if deployed.
+2. Paste your LLMesh API key.
+3. Hit **Connect**.
+
+Close Code fetches the model list and drops you into the chat view. Settings are remembered in `~/.closecode/config.json`.
+
+> Upgrading from the old `ovo` package? Your `~/.ovo` directory is migrated to `~/.closecode` automatically on first launch, sessions intact. You can `pip uninstall ovo` afterwards.
+
+---
+
+## 🌐 Deploying LLMesh to Render
+
+The repo ships a [`render.yaml`](render.yaml) blueprint, so deployment is a form and two secrets. The condensed version is below; [`DEPLOYMENT.md`](DEPLOYMENT.md) has the fully expanded walkthrough.
+
+### Step 1 — Create a Neon Postgres database
+
+1. Sign up at [neon.tech](https://neon.tech) and create a project.
+2. Copy the connection string from the dashboard. It looks like:
+
+   ```
+   postgresql://neondb_owner:PASSWORD@ep-xxx-pooler.us-east-2.aws.neon.tech/neondb?sslmode=require
+   ```
+
+Nothing else to do — LLMesh creates its own tables on first boot.
+
+### Step 2 — Deploy the blueprint
+
+1. Push this repo to GitHub.
+2. In Render: **New → Blueprint**, and select the repo. Render reads `render.yaml`.
+3. Fill in the variables Render marks as required:
+
+   | Variable | Value |
+   | :-- | :-- |
+   | `DATABASE_URL` | Your Neon connection string from step 1 |
+   | `ADMIN_PASSWORD_HASH` | bcrypt hash of your admin password (below) |
+   | `OPENROUTER_API_KEY` | From [openrouter.ai/keys](https://openrouter.ai/keys) |
+   | `GROQ_API_KEY` | From [console.groq.com/keys](https://console.groq.com/keys) |
+   | `NVIDIA_NIM_API_KEY` | From [build.nvidia.com](https://build.nvidia.com/) |
+
+   Generate the admin hash locally:
+
+   ```bash
+   python -c "import bcrypt; print(bcrypt.hashpw(b'your_password', bcrypt.gensalt()).decode())"
+   ```
+
+4. Deploy. Render builds, runs the health check against `/healthz`, and gives you a URL.
+
+`SESSION_SECRET_KEY` is generated by Render automatically. `DOMAIN` and `API_BASE_URL` are derived from Render's injected `RENDER_EXTERNAL_URL`, so CORS works on the generated hostname without configuration.
+
+### Step 3 — Seed models and mint a key
+
+1. Open `https://your-service.onrender.com/dashboard` and log in as admin.
+2. Add your upstream servers and models, or run the seed script against the same database:
+
+   ```bash
+   DATABASE_URL="postgresql://..." python -m scripts.seed_servers
+   ```
+
+3. Register a user on the landing page to mint an LLMesh API key — that's what you paste into Close Code.
+
+> **Free-plan note.** Render's free web services sleep after inactivity, so the first request after an idle period takes a few seconds to wake. Neon's free compute suspends too; `pool_pre_ping` and a 300s connection recycle are already configured to handle both cleanly.
+
+---
+
+## 🖥️ Running LLMesh locally
+
+```bash
+git clone https://github.com/Dhanugupta0/LLMesh.git
+cd LLMesh
+
+python -m venv .venv && source .venv/bin/activate
+pip install -r requirements.txt
+
+cp .env.example .env      # then fill in your provider keys
+export DEV=1
+./start.sh
+```
+
+The gateway comes up on `http://localhost:8087`. With no `DATABASE_URL` set it uses a local SQLite file at `app/database/myapi.db` — no Postgres needed for development.
+
+### With Docker
+
+```bash
+cp .env.example .env      # fill in your keys
+docker compose up -d
+```
+
+Add `--profile with-nginx` to bring up the bundled Nginx reverse proxy.
+
+---
+
+## ⌨️ Command reference
+
+Slash commands inside Close Code:
+
+| Command | Description |
+| :--- | :--- |
+| `/help` | Display the command reference |
+| `/models` | List models with provider and live status |
+| `/model <N>` | Switch to a model by index |
+| `/sessions` | List locally saved conversations |
+| `/session <N>` | Restore a previous conversation |
+| `/save` | Force-save the current session |
+| `/rename <T>` | Rename the current session |
+| `/new` | Start a fresh session |
+| `/clear` | Clear the display, keep the session |
+| `/exit` | Exit Close Code |
+
+---
+
+## 🛠️ Configuration
+
+### Close Code (client)
+
+Config lives at `~/.closecode/config.json`, written by the onboarding screen. Environment variables override it:
+
+| Variable | Description |
+| :-- | :-- |
+| `CLOSECODE_API_URL` | LLMesh endpoint (also accepts `LLMESH_API_URL`) |
+| `CLOSECODE_API_KEY` | LLMesh API key (also accepts `LLMESH_API_KEY`) |
+
+| Path | Contents |
+| :-- | :-- |
+| `~/.closecode/config.json` | Endpoint, key, model and UI preferences |
+| `~/.closecode/sessions/` | Conversation history, one JSON file per session |
+| `~/.closecode/logs/` | Client logs |
+
+### LLMesh (gateway)
+
+Full list with comments in [`.env.example`](.env.example). The ones that matter:
+
+| Variable | Default | Description |
+| :-- | :-- | :-- |
+| `DATABASE_URL` | *(unset)* | Postgres connection string. Unset ⇒ SQLite. |
+| `PGHOST` / `PGUSER` / `PGPASSWORD` / `PGDATABASE` | *(unset)* | Neon's discrete variables — used when `DATABASE_URL` is unset |
+| `DATABASE_PATH` | `app/database/myapi.db` | SQLite file location |
+| `SESSION_SECRET_KEY` | — | Signing key for admin sessions. Required in production. |
+| `ADMIN_USERNAME` | `admin` | Dashboard login |
+| `ADMIN_PASSWORD_HASH` | — | bcrypt hash of the admin password |
+| `OPENROUTER_API_KEY` | — | Upstream provider key |
+| `GROQ_API_KEY` | — | Upstream provider key |
+| `NVIDIA_NIM_API_KEY` | — | Upstream provider key |
+| `DEFAULT_LIMIT` | `1000000` | Default per-key token quota |
+| `PORT` | `8087` | Bind port (Render sets this automatically) |
+| `WEB_CONCURRENCY` | `4` | Gunicorn worker count |
+
+**Postgres notes.** `postgres://` and `postgresql://` URLs are both accepted and rewritten onto `asyncpg`. libpq-only parameters (`sslmode`, `channel_binding`, ...) are stripped and translated into a real SSL context, so you can paste a Neon string verbatim. Prepared-statement caching is disabled so pooled endpoints (Neon's `-pooler` host, PgBouncer, Supavisor) work without extra configuration.
+
+---
+
+## 📡 API
+
+LLMesh speaks the OpenAI wire format, so any OpenAI-compatible client works — not just Close Code.
+
+```bash
+curl https://your-service.onrender.com/v1/chat/completions \
+  -H "Authorization: Bearer $LLMESH_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "llama-3.3-70b-versatile",
+    "messages": [{"role": "user", "content": "Hello"}],
+    "stream": true
+  }'
+```
+
+| Endpoint | Purpose |
+| :-- | :-- |
+| `GET /healthz` | Liveness probe; 503 if the database is unreachable |
+| `GET /v1/models` | List available models |
+| `POST /v1/chat/completions` | Chat, streaming or buffered |
+| `POST /v1/completions` | Legacy completions |
+| `POST /v1/embeddings` | Embeddings |
+| `GET /dashboard` | Admin UI |
+
+---
+
+## 📦 Releasing the client to PyPI
+
+Publishing is automated by [`.github/workflows/publish.yml`](.github/workflows/publish.yml) using PyPI Trusted Publishing, so no API token is stored anywhere. Full walkthrough in [`DEPLOYMENT.md`](DEPLOYMENT.md).
+
+**One-time setup** — on [pypi.org/manage/account/publishing](https://pypi.org/manage/account/publishing/), add a pending publisher:
+
+| Field | Value |
+| :-- | :-- |
+| PyPI project | `closecode` |
+| Owner | `Dhanugupta0` |
+| Repository | `LLMesh` |
+| Workflow | `publish.yml` |
+| Environment | `pypi` |
+
+**Each release:**
+
+```bash
+# bump __version__ in closecode/__init__.py (the single source of truth —
+# pyproject.toml reads it from there), commit, then:
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+The workflow checks the tag matches the project version, builds an sdist and wheel, verifies `theme.tcss` is bundled, and uploads. To build locally:
+
+```bash
+pip install build twine
+python -m build
+twine check dist/*
+```
+
+---
+
+## 🗂️ Repository layout
+
+```
+.
+├── closecode/            # ⬡ the pip-installable terminal client
+│   ├── app.py            #   Textual App, slash commands, streaming loop
+│   ├── config.py         #   ~/.closecode config + legacy ~/.ovo migration
+│   ├── sessions.py       #   local JSON session persistence
+│   ├── llmesh/           #   HTTP client + SSE parsing
+│   └── ui/               #   screens, widgets, theme.tcss
+│
+├── app/                  # 🌐 the LLMesh FastAPI gateway
+│   ├── api/routes.py     #   OpenAI-compatible + dashboard routes
+│   ├── core/             #   lifespan, middleware, background refresh
+│   ├── database/         #   SQLAlchemy models, Postgres/SQLite engine
+│   ├── services/         #   routing, usage queue, provider clients
+│   └── config/settings.py#   environment configuration
+│
+├── static/ · templates/  # landing page + dashboard
+├── scripts/              # database init and model seeding
+├── DEPLOYMENT.md         # Render + PyPI step-by-step guide
+├── render.yaml           # Render blueprint
+├── Dockerfile · docker-compose.yml
+└── pyproject.toml        # closecode packaging
+```
+
+---
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE).
+
+<div align="center">
+  <sub>Built with 🖤 · <a href="https://pypi.org/project/closecode/">closecode on PyPI</a></sub>
+</div>