@sns-myagent/cli 0.3.8 → 0.3.9

package/CHANGELOG.md

@@ -10,6 +10,14 @@ Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
 ## [Unreleased]
 
 ### Added
+- **BYOK Quick Setup tab** in setup wizard (`src/modes/setup-wizard/scenes/byok-setup.ts`):
+  - New "BYOK" tab alongside "Sign in" and "Web search" in the providers scene
+  - Enter Base URL + API Key + select API type (openai-completions, anthropic-messages, google-generative-ai, etc.)
+  - Auto-detects available models from the provider's `/models` endpoint
+  - Saves provider config to `~/.sns-myagent/models.yml`
+  - Shows confirmation with detected model count
+  - Setup version bumped to 2
+- **Interactive memory backend selection** (v0.3.8) — choose mnemopi/hindsight/mnemopi/local/off at first run
 - **TBM (Token Budget Manager) fully implemented** — 7 core modules:
   - Context Delta Cache: static/dynamic message splitting, ~40% token savings
   - Context Pyramid: 5 compression levels (L0–L4), auto-demotion based on budget pressure

package/README.md

@@ -18,19 +18,19 @@
 </p>
 
 <p align="center">
-  <strong>BYOK coding agent CLI — 30 built-in tools, 61 slash commands, multi-provider LLM, memory, MCP, Telegram.</strong>
+  <strong>BYOK coding agent CLI — 30 built-in tools, 68 slash commands, multi-provider LLM, memory, MCP, Telegram.</strong>
 </p>
 
 <p align="center">
   <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License: MIT"></a>
-  <img src="https://img.shields.io/badge/version-0.2.0-yellow?style=flat-square" alt="Version 0.2.0">
+  <img src="https://img.shields.io/badge/version-0.3.8-yellow?style=flat-square" alt="Version 0.3.8">
   <img src="https://img.shields.io/badge/bun-%3E%3D1.3.14-efbbf4?style=flat-square&logo=bun&logoColor=black" alt="Bun >= 1.3.14">
   <img src="https://img.shields.io/badge/typescript-5.x-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript 5.x">
 </p>
 
 ---
 
-**snscoder** is a personal, single-user AI coding agent CLI. Bring your own API key, talk to the agent, and it configures itself — MCP servers, memory backends, model switching, all through conversation. Forked from [Pi Agent / oh-my-pi](https://github.com/can1357/oh-my-pi) and stripped to a focused, local-first, terminal-first agent.
+**snsagent** is a personal, single-user AI coding agent CLI. Bring your own API key, talk to the agent, and it configures itself — MCP servers, memory backends, model switching, all through conversation. Purpose-built for single-user terminal use with conversational configuration.
 
 ---
 
@@ -41,6 +41,7 @@
 - [Slash Commands](#slash-commands)
 - [Memory Backends](#memory-backends)
 - [Installation](#installation)
+- [Termux (Android)](#termux-android)
 - [Quick Start](#quick-start)
 - [Configuration](#configuration)
 - [CLI Reference](#cli-reference)
@@ -59,9 +60,10 @@
 
 | Feature | Source |
 |---------|--------|
-| **30 built-in tools** | `src/tools/builtin-names.ts` |
-| **157 built-in slash commands** | `src/slash-commands/builtin-registry.ts` |
-| **Multi-provider LLM** | OpenAI, Anthropic, Ollama, custom endpoints via `@oh-my-pi/pi-ai` |
+**30 built-in tools** | `src/tools/builtin-names.ts` |
+| **68 built-in slash commands** | `src/slash-commands/builtin-registry.ts` |
+| **Multi-provider LLM** | OpenAI, Anthropic, Ollama, custom endpoints via built-in provider system |
+| **BYOK Quick Setup** | Setup wizard tab — enter Base URL + API Key, auto-detect models, zero config editing |
 | **7 memory backends** | mnemopi (default), hindsight, mnemosyne, mem0, lcm, local, off — `src/memory-backend/resolve.ts` |
 | **MCP integration** | 22 source files in `src/mcp/` |
 | **Plan mode** | `src/plan-mode/` — agent plans before executing |
@@ -116,7 +118,6 @@ All tool names come from `src/tools/builtin-names.ts`.
 | `lsp` | Language Server Protocol operations |
 | `debug` | Debugging assistance |
 
-### Web & Browser
 ### Web & Browser
 | Tool | Description |
 |------|-------------|
@@ -158,7 +159,7 @@ All tool names come from `src/tools/builtin-names.ts`.
 
 ## Slash Commands
 
-61 built-in commands from `src/slash-commands/builtin-registry.ts`. Most useful:
+68 built-in commands from `src/slash-commands/builtin-registry.ts`. Most useful:
 
 ### Session & Navigation
 
@@ -181,7 +182,7 @@ All tool names come from `src/tools/builtin-names.ts`.
 | `/switch` | Quick model switch (same as alt+p) |
 | `/fast [on\|off\|status]` | Toggle priority service tier |
 | `/settings` | Open settings menu |
-| `/setup` | Open provider setup wizard |
+| `/setup` | Open provider setup wizard (OAuth + BYOK + Web search) |
 
 ### Goals & Planning
 
@@ -295,7 +296,7 @@ Works on Linux, macOS, Windows, WSL. Requires Node.js 18+. Prebuilt binary downl
 git clone https://github.com/Reihantt6/sns-myagent.git
 cd sns-myagent
 bun install        # requires Bun >= 1.3.14
-bun run build      # produces bin/snscoder-linux-x64
+bun run build      # produces bin/snsagent-linux-x64
 ```
 
 ### Option 4: Windows PowerShell
@@ -327,20 +328,56 @@ Prebuilt binaries: [GitHub Releases](https://github.com/Reihantt6/sns-myagent/re
 
 ---
 
+## Termux (Android)
+
+Full guide: [`docs/termux.md`](./docs/termux.md)
+
+Quick setup on Android:
+
+```bash
+# 1. Install Termux from F-Droid (NOT Play Store)
+# 2. Update + install deps
+pkg update && pkg upgrade -y
+pkg install -y git nodejs-lts
+# 3. Install Bun
+curl -fsSL https://bun.sh/install | bash
+source ~/.bashrc
+# 4. Install SNS-MyAgent
+npm install -g @sns-myagent/cli
+# 5. Setup (BYOK wizard)
+snsagent init
+# 6. Run
+snsagent
+```
+
+---
+
 ## Quick Start
 
 ### 1. Set an API key
 
+**Option A — Environment variable (fastest)**
+
 ```bash
 export OPENAI_API_KEY="sk-..."
 # or
 export ANTHROPIC_API_KEY="sk-ant-..."
 ```
 
+**Option B — BYOK Setup Wizard (recommended)**
+
+Run `snsagent` and the setup wizard appears on first launch. Pick the **BYOK** tab, enter:
+
+1. **Base URL** — e.g. `https://api.openai.com/v1`, `https://openrouter.ai/api/v1`, `http://localhost:11434/v1` (Ollama)
+2. **API Key** — your provider key
+3. **API type** — `openai-completions` (default), `anthropic-messages`, `google-generative-ai`
+
+The wizard auto-detects available models from the provider and saves the config to the agent config directory.
+
 ### 2. Run
 
 ```bash
-snscoder
+snsagent
 ```
 
 Or from source:
@@ -370,7 +407,7 @@ bun run src/cli/entry.ts
 
 ## Configuration
 
-Config lives at `.sns-myagent/config.json` (JSON, not YAML). Source: `src/config/loader.ts`.
+Config lives at `.sns-myagent/config.yaml` (YAML, auto-migrated from old `config.json`). Source: `src/config/config-file.ts`.
 
 ### Key Config Categories
 
@@ -440,11 +477,13 @@ Access in TUI via `/settings` or through conversation.
 ## CLI Reference
 
 ```
-snscoder                          # Interactive TUI mode
-snscoder "prompt"                 # Single-prompt mode
-snscoder telegram                 # Start Telegram adapter
-snscoder --help                   # Show help
-snscoder --version                # Show version
+snsagent                          # Interactive TUI mode
+snsagent "prompt"                 # Single-prompt mode
+snsagent init                     # First-run setup: memory + BYOK provider
+snsagent setup                    # Alias for init
+snsagent telegram                 # Start Telegram adapter
+snsagent --help                   # Show help
+snsagent --version                # Show version
 ```
 
 ---
@@ -487,10 +526,10 @@ Telegram bot adapter in `src/adapters/telegram/` (4 files). Built on [grammY](ht
 export SNS_TELEGRAM_BOT_TOKEN="your-bot-token-here"
 ```
 
-3. Run snscoder — the bot auto-starts polling:
+3. Run snsagent — the bot auto-starts polling:
 
 ```bash
-snscoder
+snsagent
 ```
 
 The adapter starts automatically when `SNS_TELEGRAM_BOT_TOKEN` is set. Disable auto-start with:
@@ -502,7 +541,7 @@ export SNS_TELEGRAM_AUTOSTART=0
 Or start the Telegram adapter explicitly:
 
 ```bash
-snscoder telegram
+snsagent telegram
 ```
 
 ---
@@ -605,9 +644,9 @@ What is actually wired and working in the source tree, verified 2026-06-30:
 
 All 30 tools are real implementations, not stubs.
 
-### Slash Commands (157) — `src/slash-commands/builtin-registry.ts`
+### Slash Commands (68) — `src/slash-commands/builtin-registry.ts`
 
-157 commands registered. All callable via `/<name>` in interactive mode.
+68 unique top-level commands registered. All callable via `/<name>` in interactive mode.
 
 ### Memory Backends (7 / 7) — `src/memory-backend/resolve.ts`
 
@@ -629,7 +668,7 @@ Set via `memory.backend` in `~/.sns-myagent/config.yaml`. Default is `mnemopi`.
 
 ### Multi-Agent Orchestration — `src/agents/`
 
-7 files. `agents.yaml` config, 3 ensemble strategies (consensus / critic / best-of-N), resilience (retry + circuit-breaker + timeout), 21 tests pass. CLI `orchestrate <prompt>` is wired but executor is stubbed (returns clear "not wired yet" message).
+7 files. `agents.yaml` config, 3 ensemble strategies (consensus / critic / best-of-N), resilience (retry + circuit-breaker + timeout), 21 tests pass. CLI `orchestrate <prompt>` wired to executor via `src/agents/executor.ts`.
 
 ### Terminal UI — `src/tui/` + `src/ui/`
 
@@ -649,4 +688,4 @@ GitHub Actions runs 7-stage pipeline: typecheck, lint, build, test, diagnose, sm
 
 ## Credits
 
-Forked from [Pi Agent / oh-my-pi](https://github.com/can1357/oh-my-pi) by can1357. Stripped to a focused, single-user terminal agent with conversational configuration.
+Built with dedication for single-user terminal coding workflows.

package/bin/snsagent.js

@@ -1,47 +1,9 @@
 #!/usr/bin/env node
-// Auto-generated placeholder. fetch-binary.mjs will overwrite this with
-// the real shim (bin/snsagent.js) that execs the platform binary.
-// This placeholder exists so the npm package tarball always ships a
-// valid shim at this path — npm install -g requires it (bin field).
-// Without it, npm refuses to symlink `snsagent` to PATH.
+// Auto-generated by fetch-binary.mjs — execs the platform binary.
 import { spawn } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
-
 const here = dirname(fileURLToPath(import.meta.url));
-
-// Try common platform binary names (in order).
-const candidates = [
-	"snsagent-linux-x64",
-	"snsagent-linux-arm64",
-	"snsagent-darwin-x64",
-	"snsagent-darwin-arm64",
-	"snsagent-windows-x64.exe",
-];
-
-let binary = null;
-for (const c of candidates) {
-	try {
-		const { statSync } = await import("node:fs");
-		statSync(join(here, c));
-		binary = join(here, c);
-		break;
-	} catch {
-		continue;
-	}
-}
-
-if (!binary) {
-	process.stderr.write(
-		`✗ snsagent: platform binary not found.\n` +
-			`  Expected one of: ${candidates.join(", ")}\n` +
-			`  in ${here}\n` +
-			`\n` +
-			`  Fix: re-run 'npm rebuild @sns-myagent/cli' to retry postinstall,\n` +
-			`  or run 'curl -fsSL https://raw.githubusercontent.com/Reihantt6/sns-myagent/main/install.sh | bash'.\n`,
-	);
-	process.exit(1);
-}
-
-const r = spawn(binary, process.argv.slice(2), { stdio: "inherit" });
+const bin = join(here, "snsagent-linux-x64");
+const r = spawn(bin, process.argv.slice(2), { stdio: "inherit" });
 r.on("exit", (c) => process.exit(c ?? 0));