@sheepbun/yips 0.1.1 → 0.1.47

package/LICENSE

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

package/README.md

@@ -0,0 +1,52 @@
+# Automatic Git Versioning
+
+- **Format**: `vmajor.minor.patch` where each commit adds `+0.0.1`, patch rolls into minor after `v0.0.99 -> v0.1.00`, minor rolls into major after `v0.99.99 -> v1.0.00`.
+- **Example**: 121 commits → `v0.1.21`
+- **Usage**: Run `python version.py` to see the current version
+
+The version is recalculated from the commit count so it always reflects the repository history.
+
+## 🚀 Quick Start
+
+Yips is designed to be zero-config. The included startup script handles dependency checks, virtual environments, and configuration automatically.
+
+### 1. Clone the repository
+```bash
+git clone https://github.com/sheepbun/yips-cli.git
+cd Yips
+```
+
+### 2. Run the startup script
+```bash
+chmod +x startup.sh
+./startup.sh
+```
+
+The script will:
+*   Verify Python 3 installation.
+*   Create a virtual environment (`.venv`) if missing.
+*   Install/Update all dependencies from `requirements.txt`.
+*   Clone/update and build `llama.cpp` automatically, enabling CUDA when an NVIDIA CUDA environment is detected.
+*   Initialize your `.yips_config.json` on the first run.
+*   Launch the Yips CLI.
+
+## 🛠 Backends
+
+Yips supports multiple backends for maximum flexibility:
+1.  **llama.cpp** (Local, High Performance) - *Recommended*
+2.  **LM Studio** (Local, GUI-based)
+3.  **Claude CLI** (Cloud-based fallback)
+
+Use the `/backend` command within Yips to switch between them.
+
+## 🧠 Model Management
+
+Yips features a hardware-aware Model Manager. Run:
+```bash
+/model
+```
+within the CLI to manage your local models, switch between backends, or jump to the interactive downloader.
+
+## Developer documentation
+
+For persistence layout, how to add slash-command plugins, model tool tags, and setup/backend operations, see [docs/DEVELOPER.md](docs/DEVELOPER.md).

package/bin/yips.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+const { spawnSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const isWin = os.platform() === 'win32';
+const ext = isWin ? '.exe' : '';
+const binPath = path.join(__dirname, `yips${ext}`);
+
+const result = spawnSync(binPath, process.argv.slice(2), { stdio: 'inherit' });
+if (result.error) {
+    console.error(`Failed to execute Yips binary at ${binPath}:`, result.error.message);
+    process.exit(1);
+}
+process.exit(result.status || 0);

package/package.json

@@ -1,128 +1,21 @@
-{
-  "name": "@sheepbun/yips",
-  "version": "0.1.1",
-  "description": "Local-first AI code editor and self-hosted gateway (TypeScript rewrite).",
-  "license": "UNLICENSED",
-  "homepage": "https://yips.dev",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/sheepbun/yips.git"
-  },
-  "bugs": {
-    "url": "https://github.com/sheepbun/yips/issues"
-  },
-  "main": "dist/app/index.js",
-  "bin": {
-    "yips": "dist/app/index.js"
-  },
-  "files": [
-    "dist/**",
-    "install.sh"
-  ],
-  "imports": {
-    "#app/*": {
-      "development": "./src/app/*.ts",
-      "default": "./dist/app/*.js"
-    },
-    "#agent/conductor": {
-      "development": "./src/agent/conductor.ts",
-      "default": "./dist/agent/conductor.js"
-    },
-    "#agent/commands/*": {
-      "development": "./src/agent/commands/*.ts",
-      "default": "./dist/agent/commands/*.js"
-    },
-    "#agent/context/*": {
-      "development": "./src/agent/context/*.ts",
-      "default": "./dist/agent/context/*.js"
-    },
-    "#agent/protocol/*": {
-      "development": "./src/agent/protocol/*.ts",
-      "default": "./dist/agent/protocol/*.js"
-    },
-    "#agent/tools/*": {
-      "development": "./src/agent/tools/*.ts",
-      "default": "./dist/agent/tools/*.js"
-    },
-    "#agent/skills/*": {
-      "development": "./src/agent/skills/*.ts",
-      "default": "./dist/agent/skills/*.js"
-    },
-    "#config/*": {
-      "development": "./src/config/*.ts",
-      "default": "./dist/config/*.js"
-    },
-    "#gateway/*": {
-      "development": "./src/gateway/*.ts",
-      "default": "./dist/gateway/*.js"
-    },
-    "#llm/*": {
-      "development": "./src/llm/*.ts",
-      "default": "./dist/llm/*.js"
-    },
-    "#models/*": {
-      "development": "./src/models/*.ts",
-      "default": "./dist/models/*.js"
-    },
-    "#types/*": {
-      "development": "./src/types/*.ts",
-      "default": "./dist/types/*.js"
-    },
-    "#ui/*": {
-      "development": "./src/ui/*.ts",
-      "default": "./dist/ui/*.js"
-    },
-    "#ui/prompt/*": {
-      "development": "./src/ui/prompt/*.ts",
-      "default": "./dist/ui/prompt/*.js"
-    },
-    "#ui/input/*": {
-      "development": "./src/ui/input/*.ts",
-      "default": "./dist/ui/input/*.js"
-    },
-    "#ui/downloader/*": {
-      "development": "./src/ui/downloader/*.ts",
-      "default": "./dist/ui/downloader/*.js"
-    },
-    "#ui/model-manager/*": {
-      "development": "./src/ui/model-manager/*.ts",
-      "default": "./dist/ui/model-manager/*.js"
-    },
-    "#ui/tui/*": {
-      "development": "./src/ui/tui/*.ts",
-      "default": "./dist/ui/tui/*.js"
-    }
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "dev": "tsx --conditions=development src/app/index.ts",
-    "gateway:discord": "tsx --conditions=development src/gateway/runtime/discord-main.ts",
-    "start": "node dist/app/index.js",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \".github/**/*.yml\" \"*.json\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \".github/**/*.yml\" \"*.json\""
-  },
-  "devDependencies": {
-    "@types/node": "^22.13.4",
-    "@types/react": "^18.3.26",
-    "@typescript-eslint/eslint-plugin": "^7.18.0",
-    "@typescript-eslint/parser": "^7.18.0",
-    "eslint": "^8.57.1",
-    "prettier": "^3.5.3",
-    "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
-    "vitest": "^3.0.7"
-  },
-  "dependencies": {
-    "discord.js": "^14.22.1",
-    "ink": "^4.4.1",
-    "node-pty": "^1.1.0",
-    "react": "^18.3.1"
-  }
-}
+{
+  "name": "@sheepbun/yips",
+  "version": "0.1.47",
+  "description": "Yips Personal Desktop Agent",
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "bin": {
+    "yips": "bin/yips.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sheepbun/yips.git"
+  },
+  "author": "Sheepbun",
+  "license": "MIT",
+  "files": [
+    "postinstall.js",
+    "bin/yips.js"
+  ]
+}

package/postinstall.js

@@ -0,0 +1,52 @@
+const fs = require('fs');
+const https = require('https');
+const path = require('path');
+const os = require('os');
+
+const isWin = os.platform() === 'win32';
+const ext = isWin ? '.exe' : '';
+const binaryName = isWin ? 'yips-core-windows.exe' : 'yips-core-linux';
+const initialUrl = `https://github.com/sheepbun/yips/releases/latest/download/${binaryName}`;
+const binDir = path.join(__dirname, 'bin');
+
+if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir);
+}
+
+const dest = path.join(binDir, `yips${ext}`);
+
+console.log(`Downloading Yips binary from ${initialUrl}...`);
+
+function download(url) {
+    https.get(url, (res) => {
+        if (res.statusCode === 301 || res.statusCode === 302 || res.statusCode === 307 || res.statusCode === 308) {
+            // Follow redirect
+            if (res.headers.location) {
+                download(res.headers.location);
+            } else {
+                console.error(`Redirect without location header (status ${res.statusCode})`);
+                process.exit(1);
+            }
+        } else if (res.statusCode === 200) {
+            const file = fs.createWriteStream(dest);
+            res.pipe(file);
+            file.on('finish', () => {
+                file.close();
+                if (!isWin) {
+                    fs.chmodSync(dest, 0o755);
+                }
+                console.log('Downloaded Yips binary successfully.');
+            });
+        } else {
+            console.error(`Failed to download: HTTP ${res.statusCode}`);
+            process.exit(1);
+        }
+    }).on('error', handleError);
+}
+
+download(initialUrl);
+
+function handleError(err) {
+    console.error('Error downloading Yips:', err.message);
+    process.exit(1);
+}

package/dist/agent/commands/command-catalog.js

@@ -1,243 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadCommandCatalog = loadCommandCatalog;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const GENERIC_DESCRIPTIONS = new Set(["Tool command", "Markdown skill", "Command"]);
-const RESTORED_COMMAND_DEFAULTS = [
-    { name: "backend", description: "Switch AI backends (llamacpp, claude)", kind: "builtin" },
-    { name: "clear", description: "Clear context and start a new session", kind: "builtin" },
-    { name: "dl", description: "Alias for /download", kind: "builtin" },
-    { name: "download", description: "Open the interactive model downloader", kind: "builtin" },
-    { name: "exit", description: "Exit Yips", kind: "builtin" },
-    { name: "fetch", description: "Retrieve and display content from a URL", kind: "tool" },
-    { name: "grab", description: "Read a file's content into context", kind: "tool" },
-    { name: "help", description: "Show available commands and tips", kind: "skill" },
-    { name: "memorize", description: "Save a fact to long-term memory", kind: "tool" },
-    { name: "model", description: "Open the Model Manager or switch to a specific model", kind: "builtin" },
-    { name: "new", description: "Start a new session", kind: "builtin" },
-    { name: "nick", description: "Set a custom nickname for a model", kind: "builtin" },
-    { name: "quit", description: "Exit Yips", kind: "builtin" },
-    { name: "search", description: "Search the web (DuckDuckGo)", kind: "tool" },
-    { name: "sessions", description: "Interactively select and load a session", kind: "builtin" },
-    { name: "stream", description: "Toggle streaming responses", kind: "builtin" },
-    { name: "tokens", description: "Show or set token counter mode and max", kind: "builtin" },
-    { name: "update", description: "Check for newer Yips versions and upgrade guidance", kind: "builtin" },
-    { name: "verbose", description: "Toggle verbose output", kind: "builtin" },
-    { name: "vt", description: "Toggle the Virtual Terminal", kind: "tool" }
-];
-function normalizeCommandName(name) {
-    return name.trim().replace(/^\/+/, "").toLowerCase();
-}
-function isGenericDescription(description) {
-    const trimmed = description.trim();
-    if (trimmed.length === 0) {
-        return true;
-    }
-    return GENERIC_DESCRIPTIONS.has(trimmed);
-}
-function normalizeDescription(description) {
-    const trimmed = description.trim();
-    return trimmed.length > 0 ? trimmed : "Command";
-}
-function sortedDirectoryEntries(path) {
-    return (0, node_fs_1.readdirSync)(path, { withFileTypes: true })
-        .filter((entry) => entry.isDirectory())
-        .map((entry) => entry.name)
-        .sort((left, right) => left.localeCompare(right));
-}
-function fileNames(path) {
-    return (0, node_fs_1.readdirSync)(path, { withFileTypes: true })
-        .filter((entry) => entry.isFile())
-        .map((entry) => entry.name)
-        .sort((left, right) => left.localeCompare(right));
-}
-function fileBasename(filename) {
-    const dotIndex = filename.lastIndexOf(".");
-    return dotIndex >= 0 ? filename.slice(0, dotIndex) : filename;
-}
-function pickCommandFile(commandDir, commandDirName, extension) {
-    if (!(0, node_fs_1.existsSync)(commandDir)) {
-        return null;
-    }
-    const names = fileNames(commandDir);
-    const extensionLower = extension.toLowerCase();
-    const targetBase = commandDirName.toLowerCase();
-    const exact = names.find((name) => {
-        if (!name.toLowerCase().endsWith(extensionLower)) {
-            return false;
-        }
-        return fileBasename(name).toLowerCase() === targetBase;
-    });
-    if (exact) {
-        return (0, node_path_1.join)(commandDir, exact);
-    }
-    const fallback = names.find((name) => name.toLowerCase().endsWith(extensionLower));
-    return fallback ? (0, node_path_1.join)(commandDir, fallback) : null;
-}
-function toNonEmptyTrimmedLines(text) {
-    return text
-        .split(/\r?\n/u)
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
-}
-function descriptionFromLines(lines) {
-    for (const line of lines) {
-        if (/^description\s*:/iu.test(line)) {
-            const extracted = line.replace(/^description\s*:\s*/iu, "").trim();
-            if (extracted.length > 0) {
-                return extracted;
-            }
-        }
-    }
-    const first = lines[0];
-    if (!first) {
-        return null;
-    }
-    const split = first.split(" - ");
-    if (split.length > 1) {
-        const remainder = split.slice(1).join(" - ").trim();
-        if (remainder.length > 0) {
-            return remainder;
-        }
-    }
-    return first;
-}
-function extractPythonDescription(contents) {
-    const docstringMatch = contents.match(/^\s*(?:#.*\r?\n|\s)*(?:"""([\s\S]*?)"""|'''([\s\S]*?)''')/u);
-    const docstring = docstringMatch?.[1] ?? docstringMatch?.[2];
-    if (!docstring) {
-        return null;
-    }
-    return descriptionFromLines(toNonEmptyTrimmedLines(docstring));
-}
-function extractMarkdownDescription(contents) {
-    const lines = toNonEmptyTrimmedLines(contents);
-    if (lines.length === 0) {
-        return null;
-    }
-    const first = lines[0];
-    if (!first) {
-        return null;
-    }
-    if (!first.startsWith("#")) {
-        return first;
-    }
-    for (const line of lines.slice(1)) {
-        if (line.startsWith("#") || line.startsWith("!") || line.startsWith("```")) {
-            continue;
-        }
-        return line;
-    }
-    const heading = first.replace(/^#+\s*/u, "").trim();
-    return heading.length > 0 ? heading : null;
-}
-function readTextSafely(path) {
-    try {
-        return (0, node_fs_1.readFileSync)(path, "utf8");
-    }
-    catch {
-        return null;
-    }
-}
-function discoverCommands(parentDir, parentKind) {
-    if (!(0, node_fs_1.existsSync)(parentDir)) {
-        return [];
-    }
-    const discovered = [];
-    for (const commandDirName of sortedDirectoryEntries(parentDir)) {
-        const commandName = normalizeCommandName(commandDirName);
-        if (commandName.length === 0) {
-            continue;
-        }
-        const commandDir = (0, node_path_1.join)(parentDir, commandDirName);
-        const pythonPath = pickCommandFile(commandDir, commandDirName, ".py");
-        const markdownPath = pickCommandFile(commandDir, commandDirName, ".md");
-        let kind = parentKind;
-        let description = null;
-        let priority = 0;
-        if (pythonPath) {
-            const contents = readTextSafely(pythonPath);
-            if (contents) {
-                description = extractPythonDescription(contents);
-            }
-            kind = "tool";
-            priority = description ? 2 : 0;
-        }
-        else if (markdownPath) {
-            const contents = readTextSafely(markdownPath);
-            if (contents) {
-                description = extractMarkdownDescription(contents);
-            }
-            kind = "skill";
-            priority = description ? 2 : 0;
-        }
-        discovered.push({
-            name: commandName,
-            description: normalizeDescription(description ?? "Command"),
-            kind,
-            implemented: false,
-            priority
-        });
-    }
-    return discovered;
-}
-function upsertCatalogEntry(catalog, candidate) {
-    const normalizedName = normalizeCommandName(candidate.name);
-    if (normalizedName.length === 0) {
-        return;
-    }
-    const normalizedCandidate = {
-        ...candidate,
-        name: normalizedName,
-        description: normalizeDescription(candidate.description)
-    };
-    const existing = catalog.get(normalizedName);
-    if (!existing) {
-        catalog.set(normalizedName, normalizedCandidate);
-        return;
-    }
-    const candidateGeneric = isGenericDescription(normalizedCandidate.description);
-    const existingGeneric = isGenericDescription(existing.description);
-    const shouldReplace = normalizedCandidate.priority > existing.priority ||
-        (normalizedCandidate.priority === existing.priority && !candidateGeneric && existingGeneric);
-    if (shouldReplace) {
-        catalog.set(normalizedName, {
-            ...normalizedCandidate,
-            implemented: existing.implemented || normalizedCandidate.implemented
-        });
-        return;
-    }
-    catalog.set(normalizedName, {
-        ...existing,
-        implemented: existing.implemented || normalizedCandidate.implemented
-    });
-}
-function loadCommandCatalog(options = {}) {
-    const projectRoot = options.projectRoot ?? process.cwd();
-    const catalog = new Map();
-    for (const descriptor of RESTORED_COMMAND_DEFAULTS) {
-        upsertCatalogEntry(catalog, {
-            ...descriptor,
-            name: normalizeCommandName(descriptor.name),
-            implemented: false,
-            priority: 1
-        });
-    }
-    const toolsDir = (0, node_path_1.join)(projectRoot, "commands", "tools");
-    const skillsDir = (0, node_path_1.join)(projectRoot, "commands", "skills");
-    for (const descriptor of discoverCommands(toolsDir, "tool")) {
-        upsertCatalogEntry(catalog, descriptor);
-    }
-    for (const descriptor of discoverCommands(skillsDir, "skill")) {
-        upsertCatalogEntry(catalog, descriptor);
-    }
-    return [...catalog.values()]
-        .sort((left, right) => left.name.localeCompare(right.name))
-        .map((descriptor) => ({
-        name: descriptor.name,
-        description: descriptor.description,
-        kind: descriptor.kind,
-        implemented: descriptor.implemented
-    }));
-}