heyio 0.1.27 → 0.1.29

package/README.md

@@ -1,6 +1,6 @@
 # 🤖 IO
 
-A personal AI assistant daemon built on the GitHub Copilot SDK. IO runs 24/7 on your machine, reachable via Telegram and a terminal TUI.
+A personal AI assistant daemon built on the GitHub Copilot SDK. IO runs 24/7 on your machine, reachable via Telegram, a web UI, and a terminal TUI.
 
 [![CI](https://github.com/michaeljolley/io/actions/workflows/ci.yml/badge.svg)](https://github.com/michaeljolley/io/actions/workflows/ci.yml)
 ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
@@ -9,7 +9,8 @@ A personal AI assistant daemon built on the GitHub Copilot SDK. IO runs 24/7 on
 ## ✨ Features
 
 - **Copilot SDK Integration** — powered by GitHub's Copilot SDK for LLM conversations with tool calling
-- **Multi-Interface** — Telegram bot + terminal TUI + HTTP API (future web UI)
+- **Multi-Interface** — Web UI + Telegram bot + terminal TUI + HTTP API
+- **Web Frontend** — Vue 3 dashboard with chat, squad management, skills, and agent activity views
 - **Persistent Memory** — wiki-based knowledge base stored at `~/.io/wiki/`
 - **Squad System** — persistent project teams that remember decisions, context, and history
 - **Skills** — modular skill system; install from git repos or the [skills.sh](https://skills.sh) registry
@@ -113,10 +114,12 @@ IO stores its configuration at `~/.io/config.json`. The setup wizard (`io setup`
 | `modelTiers.high` | `string[]` | `["claude-opus-4.7", "claude-opus-4.6"]` | Models for complex tasks (architecture, debugging, design) |
 | `modelTiers.medium` | `string[]` | `["claude-sonnet-4.6", "gpt-5.5", "claude-opus-4.5"]` | Models for standard tasks (features, tests, reviews) |
 | `modelTiers.low` | `string[]` | `["claude-haiku-4.5", "gpt-5.4-mini"]` | Models for simple tasks (reads, formatting, lookups) |
-| `apiPort` | `number` | `3170` | Port for the HTTP API server |
+| `port` | `number` | `3170` | Port for the HTTP server (API + web frontend) |
 
 Each `modelTiers` list is a ranked preference — IO picks the first available model at startup.
 
+> **Migration note:** If your config uses the old `apiPort` field, IO will automatically migrate it to `port`.
+
 ### Example
 
 ```jsonc
@@ -126,7 +129,7 @@ Each `modelTiers` list is a ranked preference — IO picks the first available m
   "telegramEnabled": true,
   "selfEditEnabled": false,
   "defaultModel": "claude-sonnet-4.6",
-  "apiPort": 3170,
+  "port": 3170,
   "modelTiers": {
     "high": ["claude-opus-4.7", "claude-opus-4.6"],
     "medium": ["claude-sonnet-4.6", "gpt-5.5", "claude-opus-4.5"],
@@ -182,7 +185,7 @@ IO's orchestrator automatically creates and manages squads based on your convers
 ## 🏗️ Architecture
 
 ```
-User → [TUI / Telegram / HTTP API]
+User → [Web UI / TUI / Telegram / HTTP API]
                 ↓
          Orchestrator (Copilot SDK)
           ↕           ↕
@@ -197,6 +200,17 @@ For complex tasks, the orchestrator delegates work to **Worker Agents** — shor
 
 The **Squad System** provides persistent project context, while the **Wiki** serves as a long-term knowledge base that spans all conversations.
 
+### Web Frontend
+
+IO includes a Vue 3 web dashboard served directly from the daemon on the same port as the API (default: 3170). The frontend provides:
+
+- **Chat** — real-time conversation with SSE streaming
+- **Squads** — view and manage project squads
+- **Skills** — browse installed skills
+- **Agent Activity** — monitor running worker agents
+
+Access the web UI at `http://your-server:3170/` when running in daemon mode.
+
 ## 🏗️ Project Structure
 
 ```
@@ -227,7 +241,15 @@ src/
 ├── tui/
 │   └── index.ts          # Terminal UI
 └── api/
-    └── server.ts         # Express HTTP + SSE
+    └── server.ts         # Express HTTP + SSE + static frontend
+
+web/                        # Vue 3 frontend (built to web-dist/)
+├── src/
+│   ├── views/            # ChatView, SquadsView, SkillsView, AgentActivityView
+│   ├── router/           # Vue Router config
+│   └── main.ts           # App entry
+├── vite.config.ts        # Vite config (builds to ../web-dist/)
+└── package.json
 ```
 
 ## 🛠️ Development

package/dist/api/server.js

@@ -127,14 +127,14 @@ export async function startApiServer() {
     if (existsSync(WEB_DIST)) {
         app.use(express.static(WEB_DIST));
         // SPA fallback — serve index.html for any non-API route
-        app.get("*", (_req, res) => {
+        app.get("/{*splat}", (_req, res) => {
             res.sendFile(path.join(WEB_DIST, "index.html"));
         });
         console.log("[io] Web frontend enabled");
     }
     return new Promise((resolve) => {
-        app.listen(config.apiPort, () => {
-            console.log(`[io] API server listening on port ${config.apiPort}`);
+        app.listen(config.port, () => {
+            console.log(`[io] Server listening on port ${config.port}`);
             resolve();
         });
     });

package/dist/config.js

@@ -3,7 +3,7 @@ import { CONFIG_PATH, IO_HOME } from "./paths.js";
 const DEFAULT_CONFIG = {
     telegramEnabled: false,
     selfEditEnabled: false,
-    apiPort: 3170,
+    port: 3170,
 };
 function loadConfig() {
     mkdirSync(IO_HOME, { recursive: true });
@@ -14,6 +14,11 @@ function loadConfig() {
     try {
         const raw = readFileSync(CONFIG_PATH, "utf-8");
         const parsed = JSON.parse(raw);
+        // Migrate apiPort → port
+        if (parsed.apiPort != null && parsed.port == null) {
+            parsed.port = parsed.apiPort;
+        }
+        delete parsed.apiPort;
         return { ...DEFAULT_CONFIG, ...parsed };
     }
     catch {

package/dist/copilot/system-message.js

@@ -32,7 +32,7 @@ You are a Node.js daemon process built with the Copilot SDK. Here's how you work
 - **Telegram bot**: Messages arrive tagged with \`[via telegram]\`. Keep responses concise and mobile-friendly.
 - **Local TUI**: A terminal interface on the local machine. Messages arrive tagged with \`[via tui]\`. You can be more verbose here.
 - **Background tasks**: Messages tagged \`[via background]\` are results from squad workers you delegated to.
-- **HTTP API**: You expose a local API on port ${config.apiPort} for programmatic access.
+- **HTTP API**: You expose a local API on port ${config.port} for programmatic access.
 
 When no source tag is present, assume TUI.
 
@@ -105,7 +105,7 @@ The model is selected automatically. Tell the user which model tier was chosen w
 - \`skill_search\`: Search the skills.sh registry for available skills.
 
 ### Configuration
-- \`config_update\`: Update IO's configuration (defaultModel, telegramEnabled, selfEditEnabled, apiPort).
+- \`config_update\`: Update IO's configuration (defaultModel, telegramEnabled, selfEditEnabled, port).
 - \`check_update\`: Check if a newer version of IO is available.
 
 ### System

package/dist/copilot/tools.js

@@ -292,7 +292,7 @@ export function createTools(deps) {
         skipPermission: true,
         parameters: z.object({
             key: z
-                .enum(["defaultModel", "telegramEnabled", "selfEditEnabled", "apiPort"])
+                .enum(["defaultModel", "telegramEnabled", "selfEditEnabled", "port"])
                 .describe("Config key to update"),
             value: z
                 .union([z.string(), z.number(), z.boolean()])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "heyio",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "IO — a personal AI assistant built on the GitHub Copilot SDK",
   "bin": {
     "io": "dist/index.js"