tg-claude 0.2.0 → 0.2.1

package/README.md

@@ -15,54 +15,49 @@ Control Claude Code from your phone via Telegram. Get notifications when Claude
 
 ### Prerequisites
 
-- Node.js 20 or higher
-- Claude Code CLI installed and authenticated (`npm install -g @anthropic-ai/claude-code`)
+- Node.js 20+
+- [Claude Code CLI](https://github.com/anthropics/claude-code) installed and authenticated
 - A Telegram account
 
-### 1. Create a Telegram Bot
-
-1. Open Telegram and message [@BotFather](https://t.me/BotFather)
-2. Send `/newbot`
-3. Follow the prompts to name your bot
-4. Copy the bot token you receive (looks like `123456789:ABCdefGHI...`)
-
-### 2. Get Your Telegram User ID
-
-1. Message [@userinfobot](https://t.me/userinfobot) on Telegram
-2. Copy your numeric user ID (just a number like `123456789`)
-
-### 3. Install and Configure
-
-**Option A: Global Install (recommended)**
+### Installation
 
 ```bash
 npm install -g tg-claude
 ```
 
-**Option B: npx (no install)**
+### Setup (Interactive Wizard)
+
+Just run the command — the setup wizard guides you through everything:
 
 ```bash
-npx tg-claude "Your prompt"
+tg-claude
 ```
 
-Set your environment variables:
+The wizard will:
+1. **Walk you through creating a Telegram bot** via @BotFather
+2. **Help you get your user ID** from @userinfobot
+3. **Save credentials** to `.env` automatically
+
+That's it! Now run with a prompt:
 
 ```bash
-export TELEGRAM_BOT_TOKEN="your_bot_token"
-export TELEGRAM_USER_ID="your_user_id"
+tg-claude "Fix the bug in app.js"
 ```
 
-Or create a `.env` file in your working directory:
+### Alternative: npx (no install)
 
 ```bash
-cp .env.example .env
-# Edit .env with your values
+npx tg-claude
 ```
 
-### 4. Run
+> **Note:** With npx, the `.env` file is created in your current directory. Run from your project folder.
+
+### Re-run Setup
+
+To reconfigure your Telegram credentials anytime:
 
 ```bash
-tg-claude "Fix the bug in app.js"
+tg-claude --setup
 ```
 
 ## Usage
@@ -75,6 +70,7 @@ tg-claude [options] "Your prompt"
 
 | Flag | Description |
 |------|-------------|
+| `--setup` | Run setup wizard to configure Telegram credentials |
 | `--help`, `-h` | Show help message |
 | `--version`, `-v` | Show version number |
 | `--verbose` | Show additional logging |
@@ -144,17 +140,31 @@ npm install -g @anthropic-ai/claude-code
 claude auth login
 ```
 
-### "Permission denied" on global install
+### "Permission denied" or EACCES errors
 
-Use sudo or configure npm for global installs without sudo:
+Fix npm permissions (recommended one-time fix):
+
+```bash
+sudo chown -R $(whoami) ~/.npm
+```
+
+Then install normally:
+
+```bash
+npm install -g tg-claude
+```
+
+Or use a custom npm prefix:
 
 ```bash
-sudo npm install -g tg-claude
-# or
 npm config set prefix ~/.npm-global
-export PATH=~/.npm-global/bin:$PATH
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
+source ~/.zshrc
+npm install -g tg-claude
 ```
 
+> **Avoid using sudo with npx** — it creates files with root ownership which causes issues.
+
 ### Bot not responding
 
 1. Make sure you messaged your bot at least once to start a conversation

package/dist/index.js

@@ -18,7 +18,7 @@ function escapeHtml(text) {
  * Supports multi-turn conversations via Telegram with --resume.
  */
 // Package version for --version flag
-const VERSION = '0.2.0';
+const VERSION = '0.2.1';
 // Load and validate environment variables
 const env = loadEnv();
 // Parse command line arguments

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tg-claude",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Bridge between Claude Code CLI and Telegram for mobile interaction",
   "type": "module",
   "main": "dist/index.js",