codemini-cli 0.1.1

package/LICENSE

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

@@ -0,0 +1,202 @@
+# Operations Guide
+
+## Purpose
+
+This document is the day-to-day operator guide for CodeMini CLI.
+
+Use it for:
+- common commands
+- interactive chat workflow
+- plan/spec flow
+- session recovery
+- troubleshooting combos
+
+Use [deployment.md](/mnt/e/Git%20Projects/qurio-coder/deployment.md) for packaging, installation, and deployment instead.
+
+## Core Commands
+
+```text
+codemini [prompt]
+codemini chat [prompt]
+codemini run <task>
+codemini config set|get|list <key> [value]
+codemini doctor
+codemini skill list|install|enable|disable|inspect|reindex
+```
+
+## First-Time Setup
+
+### Windows / PowerShell
+
+```powershell
+codemini config set gateway.base_url https://your-internal-gateway/v1
+codemini config set gateway.api_key your_token
+codemini config set model.name your_model_id
+codemini config set shell.default powershell
+codemini config set ui.language en
+codemini doctor
+```
+
+### macOS / Linux
+
+```bash
+codemini config set gateway.base_url https://your-internal-gateway/v1
+codemini config set gateway.api_key your_token
+codemini config set model.name your_model_id
+codemini config set shell.default bash
+codemini config set ui.language en
+codemini doctor
+```
+
+## Common Command Combos
+
+### Start an interactive session
+
+```powershell
+codemini
+```
+
+Good first prompts:
+
+```text
+Read the README and summarize what this repository does.
+Search for auth-related code and show me the key entrypoints.
+Locate where shell.default is applied and explain the flow.
+```
+
+### Run a one-off task
+
+```powershell
+codemini run "Search the repo for configuration loading logic, inspect the relevant files, and summarize how config is merged."
+```
+
+### Inspect current configuration
+
+```powershell
+codemini config get shell.default
+codemini config get model.name
+codemini config get ui.language
+codemini config list
+```
+
+### Change runtime mode quickly
+
+```powershell
+codemini config set shell.default powershell
+codemini config set ui.language en
+codemini config set soul.preset professional
+```
+
+```bash
+codemini config set shell.default bash
+codemini config set ui.language zh
+```
+
+### Run diagnostics
+
+```powershell
+codemini doctor
+codemini config list
+codemini --plain
+```
+
+Use this when you want to separate:
+- gateway issues
+- config issues
+- TUI-only issues
+
+## TUI Slash Commands
+
+```text
+/help
+/commands
+/config list
+/config get <key>
+/history list
+/history current
+/history resume <session_id>
+/spec <topic>
+/plan <goal>
+/plan auto <goal>
+/plan from-spec <path?>
+/agents list
+/agents run <role> <task>
+/compact
+/retry
+```
+
+Available sub-agent roles:
+
+```text
+planner
+coder
+reviewer
+tester
+```
+
+## Useful Workflows
+
+### Repo exploration
+
+```text
+Search the README for skill-related documentation.
+Continue into the relevant files and explain how skill loading works.
+Find where shell.default is used and summarize the config path.
+```
+
+### Spec and plan flow
+
+```text
+/spec Write a Windows PowerShell-first coding CLI usage spec
+/plan from-spec
+```
+
+Then continue with:
+
+```text
+Execute this plan step by step.
+```
+
+### Session recovery
+
+```text
+/history list
+/history current
+/history resume <session_id>
+```
+
+### Skill management
+
+```powershell
+codemini skill list
+codemini skill inspect superpowers-lite
+codemini skill enable brainstorming-lite
+codemini skill disable brainstorming-lite
+codemini skill reindex
+```
+
+## Better Prompt Patterns
+
+These usually work better:
+
+- `Search for auth-related code, inspect the most relevant files, then summarize the login flow.`
+- `Locate where shell.default takes effect and point me to the key files.`
+- `Update the README so English is first, but keep a Chinese section below.`
+- `Investigate why run_command keeps failing. Check config first, then the execution chain.`
+
+These are usually weaker:
+
+- `Look at this project.`
+- `Optimize this.`
+
+Better prompts usually specify:
+- what to search
+- what to inspect
+- what output format you want back
+
+## TUI Keys
+
+- `Tab`: autocomplete slash commands
+- `Up/Down`: navigate input history
+- `Ctrl+T`: expand or collapse tool details
+- `Ctrl+C`: exit

package/README.md

@@ -0,0 +1,138 @@
+# CodeMini CLI
+
+[![English](https://img.shields.io/badge/README-English-0f172a?style=for-the-badge)](#english)
+[![简体中文](https://img.shields.io/badge/README-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-2563eb?style=for-the-badge)](#简体中文)
+
+## English
+
+CodeMini CLI is a coding assistant CLI optimized for small-model workflows, with a strong focus on Windows and PowerShell.
+
+It is designed for teams that want a coding assistant that feels practical, controllable, and fast in real development environments, especially when smaller internal models are part of the workflow.
+
+### Why CodeMini CLI
+
+- Optimized for small-model workflows rather than assuming frontier-scale reasoning
+- Built with Windows and PowerShell as first-class environments
+- Keeps the default tool surface intentionally small and easier to control
+- Uses shell-aware execution policy instead of exposing unrestricted system access
+- Supports sub-agent workflows without forcing full-history context sharing
+
+### Highlights
+
+- Minimal default tools: `run_command`, `read_file`, `write_file`
+- Windows-aware shell profile with PowerShell-focused defaults
+- Safe mode enabled by default
+- Built-in lite skills for planning, execution, and collaboration
+- Tone presets through `soul`, without changing plans or code behavior
+- Sub-agents for planning, coding, review, and testing
+
+### Quick Start
+
+```bash
+codemini config set gateway.base_url http://your-internal-gateway/v1
+codemini config set gateway.api_key your_token
+codemini config set shell.default powershell
+codemini config set model.name your-30b-model
+codemini doctor
+codemini
+```
+
+For macOS or Linux:
+
+```bash
+codemini config set shell.default bash
+```
+
+### Command Overview
+
+```text
+codemini [prompt]
+codemini chat [prompt]
+codemini run <task>
+codemini config set|get|list <key> [value]
+codemini doctor
+codemini skill list|install|enable|disable|inspect|reindex
+```
+
+### Documentation
+
+- Operator guide and common command patterns: [OPERATIONS.md](/mnt/e/Git%20Projects/qurio-coder/OPERATIONS.md)
+- Packaging and deployment guide: [deployment.md](/mnt/e/Git%20Projects/qurio-coder/deployment.md)
+
+### Data Layout
+
+- Project-scoped workspace data: `.coder/`
+- Global user data on Windows: `%APPDATA%\\codemini-cli\\`
+- Restricted-environment fallback: `.codemini-cli/`
+
+### Positioning
+
+CodeMini CLI is a better fit if you want:
+- a coding CLI that behaves well with smaller models
+- a Windows and PowerShell-friendly workflow
+- a more controlled execution surface
+- multi-agent execution with stronger review and verification steps
+
+---
+
+## 简体中文
+
+CodeMini CLI 是一个为小模型工作流优化过的代码助手 CLI，重点针对 Windows 和 PowerShell 做了打磨。
+
+它更适合那些希望代码助手在真实开发环境里更稳、更可控、更实用的团队，尤其是在内部小模型参与日常工作的场景下。
+
+### 为什么做这个
+
+- 面向小模型工作流优化，而不是默认假设超大模型能力
+- 把 Windows 和 PowerShell 当作一等公民
+- 默认工具面更小，更容易控制
+- 使用 shell-aware 的执行策略，而不是无边界暴露系统能力
+- 支持 sub-agent 协作，但不会强制共享整段上下文历史
+
+### 主要特点
+
+- 默认工具极简：`run_command`、`read_file`、`write_file`
+- 面向 Windows 的 PowerShell 默认配置
+- safe mode 默认开启
+- 内置 lite skills，覆盖规划、执行和协作
+- `soul` 只影响语气，不影响计划和代码行为
+- 支持 planner、coder、reviewer、tester 多角色 sub-agent
+
+### 快速开始
+
+```bash
+codemini config set gateway.base_url http://your-internal-gateway/v1
+codemini config set gateway.api_key your_token
+codemini config set shell.default powershell
+codemini config set model.name your-30b-model
+codemini doctor
+codemini
+```
+
+如果你在 macOS 或 Linux：
+
+```bash
+codemini config set shell.default bash
+```
+
+### 命令概览
+
+```text
+codemini [prompt]
+codemini chat [prompt]
+codemini run <task>
+codemini config set|get|list <key> [value]
+codemini doctor
+codemini skill list|install|enable|disable|inspect|reindex
+```
+
+### 文档入口
+
+- 操作手册与常见命令组合：[OPERATIONS.md](/mnt/e/Git%20Projects/qurio-coder/OPERATIONS.md)
+- 打包与部署手册：[deployment.md](/mnt/e/Git%20Projects/qurio-coder/deployment.md)
+
+### 数据目录
+
+- 项目工作区数据：`.coder/`
+- Windows 全局用户数据：`%APPDATA%\\codemini-cli\\`
+- 受限环境回退目录：`.codemini-cli/`

package/bin/coder.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from '../src/cli.js';
+
+runCli(process.argv.slice(2)).catch((err) => {
+  console.error(`codemini error: ${err.message}`);
+  process.exit(1);
+});

package/deployment.md

@@ -0,0 +1,205 @@
+# Deployment Guide
+
+This document describes how to package, copy, install, configure, and verify `codemini-cli` from a `.tgz` file.
+
+## 1. Build The TGZ Package
+
+Run this in the project root on the packaging machine:
+
+```bash
+npm pack
+```
+
+Expected output:
+
+```text
+codemini-cli-0.1.0.tgz
+```
+
+If you want to verify the package contents:
+
+```bash
+tar -tf codemini-cli-0.1.0.tgz
+```
+
+## 2. Copy To The Target Machine
+
+Copy the generated `.tgz` file to the Win10 machine by one of these methods:
+
+- company internal file share
+- USB drive
+- secure artifact repository
+- SCP or similar internal transfer tool
+
+Recommended target path:
+
+```powershell
+C:\temp\codemini-cli-0.1.0.tgz
+```
+
+## 3. Environment Requirements
+
+Target machine requirements:
+
+- Windows 10
+- Node.js 20 or newer
+- npm available
+- PowerShell available
+
+Check:
+
+```powershell
+node -v
+npm -v
+```
+
+## 4. Install From TGZ
+
+Global install:
+
+```powershell
+npm install -g C:\temp\codemini-cli-0.1.0.tgz
+```
+
+If global install is blocked by company policy, install in a working directory instead:
+
+```powershell
+mkdir C:\temp\coder-test
+cd C:\temp\coder-test
+npm install C:\temp\codemini-cli-0.1.0.tgz
+```
+
+## 5. Confirm Installation
+
+If installed globally:
+
+```powershell
+codemini --help
+```
+
+If installed locally without global bin exposure:
+
+```powershell
+npx codemini --help
+```
+
+Or:
+
+```powershell
+node .\node_modules\codemini-cli\bin\coder.js --help
+```
+
+## 6. Initial Configuration
+
+Set your internal gateway, key, model, and shell:
+
+```powershell
+codemini config set gateway.base_url https://your-internal-gateway/v1
+codemini config set gateway.api_key your_token
+codemini config set model.name your_model_id
+codemini config set model.max_context_tokens 32768
+codemini config set shell.default powershell
+```
+
+Optional but recommended:
+
+```powershell
+codemini config set gateway.timeout_ms 180000
+codemini config set gateway.max_retries 2
+```
+
+Check current config:
+
+```powershell
+codemini config list
+```
+
+## 7. Smoke Test
+
+Run the built-in environment check:
+
+```powershell
+codemini doctor
+```
+
+Then launch the TUI:
+
+```powershell
+codemini
+```
+
+Inside the TUI, test these:
+
+```text
+/config list
+/history list
+/spec 写一个Win10内部CLI权限规范
+/plan from-spec
+帮我创建一个 hello.js
+读取 hello.js
+```
+
+## 8. Installed Data Locations
+
+Project-scoped data:
+
+```text
+.coder\
+```
+
+Global user/tool data on Win10:
+
+```text
+%APPDATA%\codemini-cli\
+```
+
+Typical contents:
+
+- `config.json`
+- `sessions\`
+- `skills\`
+- `input-history.json`
+
+## 9. Skills
+
+List installed skills:
+
+```powershell
+codemini skill list
+```
+
+Install a local skill:
+
+```powershell
+codemini skill install C:\path\to\skill-folder
+```
+
+Rebuild the local registry:
+
+```powershell
+codemini skill reindex
+```
+
+## 10. Uninstall
+
+Global uninstall:
+
+```powershell
+npm uninstall -g codemini-cli
+```
+
+Local uninstall inside a test directory:
+
+```powershell
+npm uninstall codemini-cli
+```
+
+## 11. Known Limitation
+
+This `.tgz` package is suitable for package distribution, but it is not a fully self-contained offline dependency bundle.
+
+If the target machine is completely air-gapped and does not already have the required npm dependencies available, prepare one of these instead:
+
+- a tested `node_modules` bundle
+- a company internal npm mirror
+- a dedicated offline installer bundle

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "codemini-cli",
+  "version": "0.1.1",
+  "description": "Coding CLI optimized for small-model workflows and Windows PowerShell",
+  "keywords": [
+    "cli",
+    "ai",
+    "coding-assistant",
+    "developer-tools",
+    "terminal",
+    "windows",
+    "powershell"
+  ],
+  "type": "module",
+  "homepage": "https://github.com/havingautism/Codemini-CLI#readme",
+  "bugs": {
+    "url": "https://github.com/havingautism/Codemini-CLI/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/havingautism/Codemini-CLI.git"
+  },
+  "bin": {
+    "codemini": "bin/coder.js",
+    "coder": "bin/coder.js"
+  },
+  "scripts": {
+    "start": "node bin/coder.js",
+    "test": "node --test tests/*.test.js",
+    "pack:offline": "npm pack"
+  },
+  "files": [
+    "bin",
+    "src",
+    "souls",
+    "templates",
+    "skills",
+    "README.md",
+    "OPERATIONS.md",
+    "deployment.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ink": "^6.3.1",
+    "openai": "^6.33.0",
+    "react": "^19.0.0"
+  },
+  "license": "MIT"
+}

package/skills/brainstorming-lite/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: brainstorming-lite
+description: Lightweight brainstorming skill for 30B-class models. Clarify scope, ask one question at a time, compare a few options, and converge before implementation.
+version: 0.1.0
+---
+
+Use this skill before adding new behavior, new features, or meaningful workflow changes.
+
+Rules:
+
+1. Ask one question at a time.
+Do not dump a long questionnaire. Pick the most important uncertainty and resolve it first.
+
+2. Stay concrete.
+Focus on purpose, constraints, success criteria, and what should be intentionally left out.
+
+3. Offer 2-3 approaches.
+Keep each option short. Lead with the recommended option and say why.
+
+4. Keep the design small.
+Write only enough design for the current scope. Do not inflate a simple task into a full spec process unless needed.
+
+5. Confirm before implementation.
+Summarize the chosen direction in a few bullets or a short paragraph, then move to execution only after alignment.
+
+Suggested flow:
+- Restate the task briefly
+- Ask the next best question
+- Propose options with tradeoffs
+- Confirm the chosen approach
+- Hand off to plan execution
+
+Avoid:
+- large ceremonies
+- repeating the full conversation
+- asking multiple independent questions in one turn
+- proposing implementation details before the problem is clear

package/skills/executing-plan-lite/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: executing-plan-lite
+description: Lightweight plan execution skill for 30B-class models. Execute the plan in small verified steps with narrow context and frequent checks.
+version: 0.1.0
+---
+
+Use this skill when a direction is chosen and the next job is to carry out implementation reliably.
+
+Rules:
+
+1. Execute the plan in small verified steps.
+Take one bounded step at a time. Avoid mixing planning, implementation, and verification into one big jump.
+
+2. Keep the active context narrow.
+Work from the smallest relevant file set and recent evidence. If needed, use sub-agents for independent subtasks.
+
+3. Search before editing.
+Use `rg` to locate code, inspect the smallest useful context, then edit.
+
+4. Verify after each meaningful change.
+Run the most relevant test or command before claiming success.
+
+5. Report progress briefly.
+Summarize what changed, what was verified, and what remains.
+
+Suggested flow:
+- identify the next step
+- search and inspect
+- edit
+- verify
+- either continue or stop at a clear checkpoint
+
+Use sub-agents when:
+- the task can be split cleanly
+- the write scope is disjoint
+- the result can be reviewed independently
+
+Avoid:
+- broad refactors without a reason
+- carrying full history into each step
+- declaring completion without verification