replit-tools 1.0.2 → 1.0.4

package/README.md

@@ -1,46 +1,52 @@
-# replit-claude-persist
+# DATA Tools
 
-**Persist Claude Code sessions, authentication, and history across Replit container restarts.**
+**One command to set up Claude Code and Codex CLI on Replit with full persistence.**
 
-When Replit containers restart, everything outside `/home/runner/workspace/` is wiped - including your Claude conversations, auth tokens, and installed binaries. This tool fixes that.
+When Replit containers restart, everything outside `/home/runner/workspace/` is wiped - including installed CLIs, conversations, auth tokens, and command history. DATA Tools fixes all of that.
 
-## Features
+## Quick Start
 
-- **Session Persistence** - Conversations survive container restarts
-- **Interactive Session Picker** - Choose which session to resume on shell start
-- **Multi-Terminal Support** - Each terminal tracks its own session
-- **Auth Persistence** - Keep your Claude authentication working
-- **Binary Caching** - Claude binary persists (faster startup)
-- **Bash History** - Command history survives restarts too
+```bash
+npx replit-tools
+```
 
-## Installation
+That's it. The installer will:
 
-### Option 1: npx (easiest)
+1. **Install Claude Code** (if not already installed)
+2. **Install OpenAI Codex CLI** (if not already installed)
+3. **Detect existing config** and preserve your data
+4. **Set up persistence** so everything survives restarts
+5. **Launch the session picker** so you can start working immediately
 
-```bash
-npx replit-claude-persist
-```
+## What Gets Installed
 
-### Option 2: curl
+| Tool | Source | Purpose |
+|------|--------|---------|
+| **Claude Code** | `curl https://claude.ai/install.sh` | Anthropic's CLI for Claude |
+| **Codex CLI** | `npm i -g @openai/codex` | OpenAI's coding assistant |
 
-```bash
-curl -fsSL https://raw.githubusercontent.com/stevemoraco/DATAtools/main/install.sh | bash
-```
+Both are installed only if not already present. Existing installations are preserved.
 
-### Option 3: Manual
+## What Gets Persisted
 
-```bash
-npm install -g replit-claude-persist
-replit-claude-persist
-```
+| Data | Location | Survives Restart? |
+|------|----------|-------------------|
+| Claude conversations | `.claude-persistent/` | Yes |
+| Claude credentials | `.claude-persistent/` | Yes |
+| Claude binary | `.local/share/claude/versions/` | Yes |
+| Codex data | `.codex-persistent/` | Yes |
+| Bash history | `.persistent-home/` | Yes |
+| Per-terminal sessions | `.claude-sessions/` | Yes |
 
-## What You'll See
+## The Session Picker
 
-After installation, opening a new shell shows:
+After installation (and on every new shell), you'll see:
 
 ```
+✅ Claude Code already installed (1.0.17)
+✅ Codex CLI already installed
+
 ✅ Claude authentication: valid (23h remaining)
-✅ Claude Code ready: 2.0.71 (Claude Code)
 
 ╭─────────────────────────────────────────────────────────╮
 │  Claude Session Manager                                 │
@@ -56,7 +62,9 @@ After installation, opening a new shell shows:
   Choice [c/r/n/s]: _
 ```
 
-Press `r` to see detailed session info:
+### Session Details
+
+Press `r` to see full session metadata:
 
 ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -69,30 +77,99 @@ Press `r` to see detailed session info:
   Latest:   "Thanks, that worked!"
 ```
 
+Each session shows:
+- Full UUID
+- Message count and file size
+- Time since last activity
+- Start and last activity timestamps
+- First and latest prompts (truncated)
+
+## Multi-Terminal Support
+
+Each terminal tracks its own session independently:
+
+```
+Terminal pts/0 → Session abc123... (your migration work)
+Terminal pts/1 → Session def456... (your docs work)
+Terminal pts/2 → Session ghi789... (your debugging)
+```
+
+Press `c` to continue YOUR terminal's last session. Other terminals are unaffected.
+
 ## How It Works
 
-The tool creates symlinks from ephemeral locations to persistent workspace storage:
+The installer creates symlinks from ephemeral locations to persistent workspace storage:
 
 ```
-~/.claude      →  /workspace/.claude-persistent/
-~/.codex       →  /workspace/.codex-persistent/
-~/.local/bin/  →  /workspace/.local/share/claude/versions/
+~/.claude           →  /workspace/.claude-persistent/
+~/.codex            →  /workspace/.codex-persistent/
+~/.local/share/claude →  /workspace/.local/share/claude/
+~/.local/bin/claude →  /workspace/.local/share/claude/versions/X.X.X
 ```
 
-On every shell start, `.config/bashrc` ensures symlinks exist and shows the session picker.
+Three layers ensure setup runs on every restart:
+1. `.replit` onBoot hook (runs at container boot)
+2. `.config/bashrc` (runs on every shell start)
+3. Scripts in `workspace/scripts/` (called by above)
+
+## Smart Detection
+
+The installer checks for:
+
+- **`CLAUDE_CONFIG_DIR`** - Respects custom Claude config directory if set in Replit Secrets
+- **Existing persistent config** - Uses your existing `.claude-persistent/` if present
+- **Replit Secrets** - Detects `ANTHROPIC_API_KEY` and `OPENAI_API_KEY`
+- **Existing installations** - Won't reinstall Claude or Codex if already present
+- **Existing data in ~/.claude** - Moves it to persistent storage instead of overwriting
+
+### Supported Environment Variables
+
+| Variable | Purpose |
+|----------|---------|
+| `CLAUDE_CONFIG_DIR` | Custom directory for Claude config/data (recommended) |
+| `CLAUDE_WORKSPACE_DIR` | Alternative name for config directory |
+| `CLAUDE_DATA_DIR` | Alternative name for config directory |
+| `CLAUDE_HOME` | Alternative name for config directory |
+| `ANTHROPIC_API_KEY` | Claude API authentication |
+| `OPENAI_API_KEY` | Codex API authentication |
+
+If you set `CLAUDE_CONFIG_DIR` in your Replit Secrets to a path inside `/home/runner/workspace/`, DATA Tools will use that directory for persistence instead of the default `.claude-persistent/`.
+
+## Installation Options
+
+### Option 1: npx (recommended)
+
+```bash
+npx replit-tools
+```
+
+### Option 2: curl
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/stevemoraco/DATAtools/main/install.sh | bash
+```
+
+### Option 3: Global install
+
+```bash
+npm install -g replit-tools
+replit-tools
+```
 
 ## Commands
 
+After installation, these aliases are available:
+
 | Command | Description |
 |---------|-------------|
-| `cr` | Continue last session |
-| `claude-menu` | Show session picker again |
-| `claude-new` | Start fresh session |
-| `claude-pick` | Claude's built-in picker |
+| `cr` | Continue last Claude session |
+| `claude-resume` | Same as `cr` |
+| `claude-pick` | Claude's built-in session picker |
+| `claude-menu` | Show the session manager menu again |
 
 ## Configuration
 
-### Disable the menu
+### Disable the session picker menu
 
 ```bash
 export CLAUDE_NO_PROMPT=true
@@ -100,32 +177,39 @@ export CLAUDE_NO_PROMPT=true
 
 Add to `.config/bashrc` to make permanent.
 
-### Fix auth permanently
+### Fix authentication permanently
 
 ```bash
 claude setup-token
 ```
 
-Creates a long-lived token that doesn't expire.
+Creates a long-lived API token that doesn't expire (OAuth tokens expire every ~24h).
 
 ## Files Created
 
 ```
 workspace/
-├── .claude-persistent/     # Conversations, credentials
+├── .claude-persistent/     # Claude conversations & credentials
 ├── .codex-persistent/      # Codex CLI data
 ├── .claude-sessions/       # Per-terminal session tracking
 ├── .local/share/claude/    # Claude binary versions
 ├── .persistent-home/       # Bash history
 ├── .config/bashrc          # Shell startup config
-└── scripts/
-    ├── setup-claude-code.sh
-    └── claude-session-manager.sh
+├── scripts/
+│   ├── setup-claude-code.sh
+│   └── claude-session-manager.sh
+└── .gitignore              # Updated to ignore credential dirs
 ```
 
 ## Troubleshooting
 
-### Menu not appearing
+### Claude or Codex not found after restart
+
+```bash
+source /home/runner/workspace/scripts/setup-claude-code.sh
+```
+
+### Session picker not appearing
 
 ```bash
 source /home/runner/workspace/.config/bashrc
@@ -142,9 +226,27 @@ claude setup-token
 ### Symlinks broken
 
 ```bash
-source /home/runner/workspace/scripts/setup-claude-code.sh
+npx replit-tools
 ```
 
+Running the installer again is safe - it preserves existing data.
+
+## Security
+
+The installer adds these to `.gitignore`:
+- `.claude-persistent/` (contains credentials)
+- `.codex-persistent/` (contains credentials)
+
+Your API keys and conversation history won't be committed to git.
+
+## Why "DATA Tools"?
+
+**D**eveloper **A**ssistant **T**ool **A**utomation - everything you need to run AI coding assistants on Replit, persisted and ready to go.
+
+## Repository
+
+GitHub: [stevemoraco/DATAtools](https://github.com/stevemoraco/DATAtools)
+
 ## License
 
 MIT

package/index.js

@@ -17,7 +17,7 @@ if (!fs.existsSync(WORKSPACE)) {
 
 console.log('');
 console.log('╭─────────────────────────────────────────────────────────╮');
-console.log('│  Replit Tools - Claude & Codex Persistence             │');
+console.log('│  DATA Tools - Claude & Codex Persistence               │');
 console.log('╰─────────────────────────────────────────────────────────╯');
 console.log('');
 
@@ -31,33 +31,66 @@ function commandExists(cmd) {
   }
 }
 
-// Helper to check for Replit secret
-function hasReplitSecret(name) {
-  return process.env[name] !== undefined;
+// Helper to get Replit secret value
+function getReplitSecret(name) {
+  return process.env[name] || null;
+}
+
+// Check for CLAUDE_CONFIG_DIR or similar env vars that specify custom Claude location
+const claudeConfigEnvVars = [
+  'CLAUDE_CONFIG_DIR',
+  'CLAUDE_WORKSPACE_DIR',
+  'CLAUDE_DATA_DIR',
+  'CLAUDE_HOME'
+];
+
+let customClaudeDir = null;
+for (const envVar of claudeConfigEnvVars) {
+  const value = getReplitSecret(envVar);
+  if (value) {
+    customClaudeDir = value;
+    console.log(`✅ Found ${envVar} = ${value}`);
+    break;
+  }
+}
+
+// Determine Claude persistent directory
+// Priority: 1) CLAUDE_CONFIG_DIR from env, 2) existing .claude-persistent, 3) default
+let claudePersistentDir = path.join(WORKSPACE, '.claude-persistent');
+
+if (customClaudeDir) {
+  // User has specified a custom directory via env var
+  if (customClaudeDir.startsWith(WORKSPACE)) {
+    // It's already in workspace - use it directly
+    claudePersistentDir = customClaudeDir;
+    console.log(`   Using custom Claude directory: ${claudePersistentDir}`);
+  } else {
+    // It's outside workspace - we'll symlink to it but also ensure persistence
+    console.log(`   Custom dir outside workspace - will set up persistence`);
+  }
 }
 
 // Check for existing persistent config
-const existingClaudeConfig = fs.existsSync(path.join(WORKSPACE, '.claude-persistent'));
+const existingClaudeConfig = fs.existsSync(claudePersistentDir);
 const existingCodexConfig = fs.existsSync(path.join(WORKSPACE, '.codex-persistent'));
 
 if (existingClaudeConfig) {
-  console.log('✅ Found existing Claude config in workspace');
+  console.log(`✅ Found existing Claude config at ${claudePersistentDir}`);
 }
 if (existingCodexConfig) {
   console.log('✅ Found existing Codex config in workspace');
 }
 
-// Check for Replit secrets
-if (hasReplitSecret('ANTHROPIC_API_KEY')) {
+// Check for API key secrets
+if (getReplitSecret('ANTHROPIC_API_KEY')) {
   console.log('✅ Found ANTHROPIC_API_KEY in Replit secrets');
 }
-if (hasReplitSecret('OPENAI_API_KEY')) {
+if (getReplitSecret('OPENAI_API_KEY')) {
   console.log('✅ Found OPENAI_API_KEY in Replit secrets');
 }
 
 // Create directories (preserving existing data)
 const dirs = [
-  '.claude-persistent',
   '.codex-persistent',
   '.claude-sessions',
   '.local/share/claude/versions',
@@ -67,6 +100,14 @@ const dirs = [
   'logs'
 ];
 
+// Add Claude persistent dir if it's relative to workspace
+if (claudePersistentDir.startsWith(WORKSPACE)) {
+  const relativePath = claudePersistentDir.replace(WORKSPACE + '/', '');
+  if (!dirs.includes(relativePath)) {
+    dirs.unshift(relativePath);
+  }
+}
+
 console.log('');
 console.log('📁 Creating directories...');
 dirs.forEach(dir => {
@@ -84,15 +125,19 @@ const claudeInstalled = commandExists('claude') ||
 
 let claudeVersions = [];
 try {
-  claudeVersions = fs.readdirSync(path.join(WORKSPACE, '.local/share/claude/versions'));
+  claudeVersions = fs.readdirSync(path.join(WORKSPACE, '.local/share/claude/versions'))
+    .filter(f => !f.startsWith('.'));
 } catch {}
 
 if (!claudeInstalled || claudeVersions.length === 0) {
   console.log('📦 Installing Claude Code...');
   try {
+    // Set CLAUDE_CONFIG_DIR before install so it installs to the right place
+    const installEnv = { ...process.env, CLAUDE_CONFIG_DIR: claudePersistentDir };
     execSync('curl -fsSL https://claude.ai/install.sh | bash', {
       stdio: 'inherit',
-      shell: '/bin/bash'
+      shell: '/bin/bash',
+      env: installEnv
     });
     console.log('✅ Claude Code installed');
   } catch (err) {
@@ -125,29 +170,30 @@ if (!codexInstalled) {
 console.log('');
 console.log('🔗 Setting up symlinks...');
 
-// Claude symlink
-const claudeTarget = path.join(WORKSPACE, '.claude-persistent');
+// Claude symlink - only if we're using default location
 const claudeLink = path.join(HOME, '.claude');
-try {
-  const stat = fs.lstatSync(claudeLink);
-  if (stat.isSymbolicLink()) {
-    const current = fs.readlinkSync(claudeLink);
-    if (current !== claudeTarget) {
-      fs.unlinkSync(claudeLink);
-      fs.symlinkSync(claudeTarget, claudeLink);
+if (!customClaudeDir || customClaudeDir.startsWith(WORKSPACE)) {
+  try {
+    const stat = fs.lstatSync(claudeLink);
+    if (stat.isSymbolicLink()) {
+      const current = fs.readlinkSync(claudeLink);
+      if (current !== claudePersistentDir) {
+        fs.unlinkSync(claudeLink);
+        fs.symlinkSync(claudePersistentDir, claudeLink);
+      }
+    } else if (stat.isDirectory()) {
+      // Move existing data to persistent location
+      console.log('   Moving existing ~/.claude data to persistent storage...');
+      execSync(`cp -rn ${claudeLink}/* ${claudePersistentDir}/ 2>/dev/null || true`, { shell: '/bin/bash' });
+      execSync(`rm -rf ${claudeLink}`, { shell: '/bin/bash' });
+      fs.symlinkSync(claudePersistentDir, claudeLink);
     }
-  } else if (stat.isDirectory()) {
-    // Move existing data to persistent location
-    console.log('   Moving existing ~/.claude data to persistent storage...');
-    execSync(`cp -rn ${claudeLink}/* ${claudeTarget}/ 2>/dev/null || true`, { shell: '/bin/bash' });
-    execSync(`rm -rf ${claudeLink}`, { shell: '/bin/bash' });
-    fs.symlinkSync(claudeTarget, claudeLink);
+  } catch {
+    // Doesn't exist, create it
+    fs.symlinkSync(claudePersistentDir, claudeLink);
   }
-} catch {
-  // Doesn't exist, create it
-  fs.symlinkSync(claudeTarget, claudeLink);
+  console.log(`   ~/.claude → ${claudePersistentDir.replace(WORKSPACE + '/', '')}/`);
 }
-console.log('   ~/.claude → .claude-persistent/');
 
 // Codex symlink
 const codexTarget = path.join(WORKSPACE, '.codex-persistent');
@@ -198,7 +244,9 @@ console.log('   ~/.local/share/claude → .local/share/claude/');
 
 // Link binary to latest version
 try {
-  const versions = fs.readdirSync(path.join(WORKSPACE, '.local/share/claude/versions')).sort();
+  const versions = fs.readdirSync(path.join(WORKSPACE, '.local/share/claude/versions'))
+    .filter(f => !f.startsWith('.'))
+    .sort();
   if (versions.length > 0) {
     const latest = versions[versions.length - 1];
     const binaryPath = path.join(WORKSPACE, '.local/share/claude/versions', latest);
@@ -228,11 +276,15 @@ scripts.forEach(script => {
   }
 });
 
-// Create/update .config/bashrc
+// Create/update .config/bashrc with CLAUDE_CONFIG_DIR export
 console.log('');
 console.log('📝 Creating .config/bashrc...');
 const bashrcContent = `#!/bin/bash
-# Replit Claude Persistence - Auto-generated bashrc
+# DATA Tools - Replit Claude & Codex Persistence
+# Auto-generated bashrc
+
+# Claude Config Directory (tells Claude where to store data)
+export CLAUDE_CONFIG_DIR="${claudePersistentDir}"
 
 # Claude Code Setup
 SETUP_SCRIPT="/home/runner/workspace/scripts/setup-claude-code.sh"
@@ -272,17 +324,17 @@ const onBootLine = 'onBoot = "source /home/runner/workspace/scripts/setup-claude
 if (fs.existsSync(replitPath)) {
   let content = fs.readFileSync(replitPath, 'utf8');
   if (!content.includes('setup-claude-code.sh')) {
-    content += '\n\n# Claude persistence (added by installer)\n' + onBootLine + '\n';
+    content += '\n\n# Claude persistence (added by DATA Tools)\n' + onBootLine + '\n';
     fs.writeFileSync(replitPath, content);
   }
 } else {
-  fs.writeFileSync(replitPath, '# Claude persistence\n' + onBootLine + '\n');
+  fs.writeFileSync(replitPath, '# Claude persistence (DATA Tools)\n' + onBootLine + '\n');
 }
 
 // Update .gitignore (only essential sensitive dirs)
 console.log('📝 Updating .gitignore...');
 const gitignorePath = path.join(WORKSPACE, '.gitignore');
-const gitignoreEntries = '\n# Claude/Codex credentials (added by replit-tools)\n.claude-persistent/\n.codex-persistent/\n';
+const gitignoreEntries = '\n# Claude/Codex credentials (added by DATA Tools)\n.claude-persistent/\n.codex-persistent/\n';
 
 if (fs.existsSync(gitignorePath)) {
   let content = fs.readFileSync(gitignorePath, 'utf8');
@@ -293,8 +345,9 @@ if (fs.existsSync(gitignorePath)) {
   fs.writeFileSync(gitignorePath, gitignoreEntries.trim() + '\n');
 }
 
-// Add PATH to current process for session manager
+// Add PATH and CLAUDE_CONFIG_DIR to current process
 process.env.PATH = `${localBin}:${process.env.PATH}`;
+process.env.CLAUDE_CONFIG_DIR = claudePersistentDir;
 
 console.log('');
 console.log('╭─────────────────────────────────────────────────────────╮');
@@ -302,18 +355,23 @@ console.log('│  ✅ Installation complete!                              │');
 console.log('╰─────────────────────────────────────────────────────────╯');
 console.log('');
 console.log('Your conversations and credentials now persist across restarts.');
+console.log(`Claude config directory: ${claudePersistentDir}`);
 console.log('');
 
 // Check if Claude needs login
 let needsLogin = true;
 try {
-  const authCheck = execSync('claude auth status 2>&1 || true', { encoding: 'utf8', shell: '/bin/bash' });
+  const authCheck = execSync('claude auth status 2>&1 || true', {
+    encoding: 'utf8',
+    shell: '/bin/bash',
+    env: { ...process.env, CLAUDE_CONFIG_DIR: claudePersistentDir }
+  });
   if (authCheck.includes('Logged in') || authCheck.includes('valid')) {
     needsLogin = false;
   }
 } catch {}
 
-if (needsLogin && !hasReplitSecret('ANTHROPIC_API_KEY')) {
+if (needsLogin && !getReplitSecret('ANTHROPIC_API_KEY')) {
   console.log('⚠️  Claude needs authentication. Run: claude login');
   console.log('');
 }
@@ -325,7 +383,8 @@ console.log('');
 // Use spawn to run bash interactively with our session manager
 const sessionManager = spawn('bash', ['--rcfile', path.join(WORKSPACE, '.config/bashrc'), '-i'], {
   stdio: 'inherit',
-  cwd: WORKSPACE
+  cwd: WORKSPACE,
+  env: { ...process.env, CLAUDE_CONFIG_DIR: claudePersistentDir }
 });
 
 sessionManager.on('exit', (code) => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "replit-tools",
-  "version": "1.0.2",
-  "description": "Persist Claude Code sessions, auth, and history across Replit container restarts",
+  "version": "1.0.4",
+  "description": "DATA Tools - One command to set up Claude Code and Codex CLI on Replit with full persistence",
   "main": "index.js",
   "bin": {
     "replit-tools": "./index.js"