claude-code-remote-pilot 0.1.3 → 0.1.5

package/bin/claude-pilot.js

@@ -78,10 +78,38 @@ async function setupTelegram() {
   console.log('Telegram configured for this session.\n');
 }
 
+function printGuide() {
+  const session = process.env.CLAUDE_SESSION;
+  const workdir = process.env.CLAUDE_WORKDIR;
+  console.log(`
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Claude Code Remote Pilot — Ready
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  Session : ${session}
+  Dir     : ${workdir}
+
+  To talk to Claude:
+    tmux attach -t ${session}
+
+  To detach without stopping Claude:
+    Press  Ctrl+B  then  D
+
+  The pilot will:
+    • detect usage/rate limits
+    • wait for the reset
+    • send "continue" automatically
+    • notify you via Telegram (if configured)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
+}
+
 async function main() {
   await ensureDep('tmux', 'tmux', tmuxInstallCmd());
   await ensureDep('claude', 'Claude Code CLI', 'npm install -g @anthropic-ai/claude-code');
   await setupTelegram();
+  printGuide();
 
   const child = spawn('bash', [scriptPath], {
     stdio: 'inherit',
@@ -98,21 +126,38 @@ if (process.argv.includes('--help') || process.argv.includes('-h')) {
 Claude Code Remote Pilot
 
 Usage:
-  claude-remote-pilot
+  claude-remote-pilot [--session <name>]
+
+Options:
+  --session <name>   Name for this Claude session (defaults to current directory name)
 
 Environment variables:
   TELEGRAM_BOT_TOKEN
   TELEGRAM_CHAT_ID
-  CLAUDE_SESSION
   CLAUDE_COMMAND
 
 Example:
-  TELEGRAM_BOT_TOKEN=xxx TELEGRAM_CHAT_ID=123456 claude-remote-pilot
+  claude-remote-pilot --session my-project
+  TELEGRAM_BOT_TOKEN=xxx TELEGRAM_CHAT_ID=123456 claude-remote-pilot --session api
 
-Attach to tmux:
-  tmux attach -t claude
+Attach to session:
+  tmux attach -t <name>
 `);
   process.exit(0);
 }
 
+// Parse --session flag, fall back to current directory name
+const sessionFlagIndex = process.argv.indexOf('--session');
+const sessionName = sessionFlagIndex !== -1
+  ? process.argv[sessionFlagIndex + 1]
+  : path.basename(process.cwd());
+
+if (!sessionName || sessionName.startsWith('--')) {
+  console.error('Error: --session requires a name, e.g. --session my-project');
+  process.exit(1);
+}
+
+process.env.CLAUDE_SESSION = sessionName;
+process.env.CLAUDE_WORKDIR = process.cwd();
+
 main();

package/claude-pilot.sh

@@ -23,6 +23,7 @@ set -u
 
 CLAUDE_SESSION="${CLAUDE_SESSION:-claude}"
 CLAUDE_COMMAND="${CLAUDE_COMMAND:-claude}"
+CLAUDE_WORKDIR="${CLAUDE_WORKDIR:-$PWD}"
 CHECK_INTERVAL_SECONDS="${CHECK_INTERVAL_SECONDS:-30}"
 LIMIT_FALLBACK_WAIT_SECONDS="${LIMIT_FALLBACK_WAIT_SECONDS:-300}"
 POST_RESUME_COOLDOWN_SECONDS="${POST_RESUME_COOLDOWN_SECONDS:-180}"
@@ -146,8 +147,8 @@ ensure_tmux_session() {
     exit 1
   fi
 
-  tmux new-session -d -s "$CLAUDE_SESSION" "$CLAUDE_COMMAND"
-  log "Started tmux session '$CLAUDE_SESSION' with command: $CLAUDE_COMMAND"
+  tmux new-session -d -s "$CLAUDE_SESSION" -c "$CLAUDE_WORKDIR" "$CLAUDE_COMMAND"
+  log "Started tmux session '$CLAUDE_SESSION' in $CLAUDE_WORKDIR"
   send_telegram "Claude Pilot: started tmux session '$CLAUDE_SESSION'."
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-remote-pilot",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Interactive Claude Code supervisor with tmux, Telegram notifications, and auto-resume after usage limits.",
   "type": "commonjs",
   "bin": {