tiger-agent 0.2.2 → 0.2.3

package/README.md

@@ -33,68 +33,94 @@ Made by **AI Research Group, Department of Civil Engineering, KMUTT**
 
 ---
 
+## 📋 Requirements
+
+- Node.js 18+ (20+ recommended)
+- npm
+- Python 3 (for SQLite memory helper)
+
+---
+
 ## 📦 Installation
 
 ```bash
 npm install -g tiger-agent
 ```
 
+All config and runtime data is stored in `~/.tiger/` — nothing written to the npm global directory.
+
 ---
 
 ## 🚀 Quick Start
 
+### 1. Run the setup wizard
+
 ```bash
-tiger onboard     # First-time setup wizard (run once)
-tiger start       # Start CLI chat
+tiger onboard
 ```
 
-CLI exit: `/exit` or `/quit`
+The wizard will ask for:
+- **Active provider** — which LLM to use by default (e.g. `zai`, `claude`)
+- **Fallback order** — comma-separated list tried when the active provider is rate-limited
+- **API keys** — enter only the providers you have keys for; others are skipped automatically
+- **Telegram bot token** — from [@BotFather](https://t.me/BotFather) on Telegram
+- **Daily token limits** — per-provider caps (0 = unlimited); auto-switches on breach
+- **Shell / skill-install** — optional tool permissions
+
+Config is saved to `~/.tiger/.env` (mode 600).
 
-**Telegram bot:**
+### 2. Start
 
+**CLI chat:**
 ```bash
-tiger telegram              # Start in foreground
-tiger telegram --background # Start as background daemon
-tiger stop                  # Stop daemon
-tiger status                # Check daemon status
+tiger start
 ```
+Exit with `/exit` or `/quit`.
 
----
+**Telegram bot (foreground):**
+```bash
+tiger telegram
+```
 
-## 📋 Requirements
+**Telegram bot (background daemon):**
+```bash
+tiger telegram --background   # start
+tiger status                  # check if running
+tiger stop                    # stop
+```
 
-- Node.js 18+ (20+ recommended)
-- npm
-- Python 3 (for SQLite memory helper)
+Logs: `~/.tiger/logs/telegram.out.log`
 
 ---
 
 ## 🎮 Run Modes
 
-| Mode | Command | Use Case |
-|------|---------|----------|
+| Mode | Command | Description |
+|------|---------|-------------|
 | **CLI** | `tiger start` | Interactive terminal chat |
 | **Telegram** | `tiger telegram` | Telegram bot (foreground) |
-| **Background** | `tiger telegram --background` | 24/7 daemon |
-| **Stop** | `tiger stop` | Kill background daemon |
-| **Status** | `tiger status` | Check if daemon is running |
-
-Background logs: `~/.tiger/logs/telegram-supervisor.log`
+| **Background** | `tiger telegram --background` | 24/7 daemon with auto-restart |
+| **Stop** | `tiger stop` | Stop background daemon |
+| **Status** | `tiger status` | Check daemon status |
+| **Onboard** | `tiger onboard` | Re-run setup wizard |
 
 ---
 
-## 🔧 Setup Wizard
+## 🔧 Setup Wizard Details
 
-`tiger onboard` creates and configures:
+`tiger onboard` writes `~/.tiger/.env` with all settings. You can re-run it at any time to update config.
 
-- `~/.tiger/.env` — settings and provider config
-- `~/.tiger/.env.secrets` — API keys (mode 600, gitignored)
+| Wizard prompt | What it sets |
+|---------------|-------------|
+| Active provider | `ACTIVE_PROVIDER` |
+| Fallback order | `PROVIDER_ORDER` |
+| API keys | `ZAI_API_KEY`, `CLAUDE_API_KEY`, etc. |
+| Telegram token | `TELEGRAM_BOT_TOKEN` |
+| Token limits | `ZAI_TOKEN_LIMIT`, `CLAUDE_TOKEN_LIMIT`, etc. |
+| Shell tool | `ALLOW_SHELL` |
+| Skill install | `ALLOW_SKILL_INSTALL` |
 
-Setup options:
-- Choose LLM provider and API keys
-- Persistent vs temporary vector DB
-- Optional `sqlite-vec` acceleration
-- Optional encrypted secrets file
+> **Tip:** You can also edit `~/.tiger/.env` directly and restart the bot to apply changes.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiger-agent",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Cognitive AI agent with persistent memory, multi-provider LLM, and Telegram bot",
   "type": "commonjs",
   "main": "src/cli.js",

package/src/agent/skills.js

@@ -4,7 +4,8 @@ const { execFile } = require('child_process');
 const { promisify } = require('util');
 
 const execFileAsync = promisify(execFile);
-const localClawhubBin = path.resolve(process.cwd(), 'node_modules', '.bin', 'clawhub');
+// Resolve clawhub from the package's own node_modules (works for both global and local installs)
+const localClawhubBin = path.resolve(__dirname, '..', '..', 'node_modules', '.bin', 'clawhub');
 
 function listSkills(baseDir) {
   if (!fs.existsSync(baseDir)) return [];

package/src/agent/toolbox.js

@@ -7,7 +7,8 @@ const { listSkills, loadSkill, clawhubSearch, clawhubInstall } = require('./skil
 const { runSubAgentBatch } = require('./subAgent');
 
 const execAsync = promisify(exec);
-const skillsDir = path.resolve('./skills');
+const rootDir = process.env.TIGER_HOME || process.cwd();
+const skillsDir = path.resolve(rootDir, 'skills');
 
 function toAbsolutePath(inputPath) {
   return path.resolve(String(inputPath || '.'));
@@ -113,7 +114,7 @@ async function clawhubSearchTool(args = {}) {
   return clawhubSearch({
     query: args.query,
     limit: args.limit,
-    workdir: args.workdir || process.cwd(),
+    workdir: args.workdir || rootDir,
     dir: args.dir || 'skills',
     timeout_ms: args.timeout_ms
   });
@@ -124,7 +125,7 @@ async function clawhubInstallTool(args = {}) {
     slug: args.slug,
     version: args.version,
     force: args.force,
-    workdir: args.workdir || process.cwd(),
+    workdir: args.workdir || rootDir,
     dir: args.dir || 'skills',
     timeout_ms: args.timeout_ms
   });