DATA Tools

One command to set up Claude Code and Codex CLI on Replit with full persistence and automatic token refresh.

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.

Quick Start

``bash
npx -y replit-tools
`

(The -y skips the "Ok to proceed?" prompt)

That's it. The installer will:

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. Auto-refresh OAuth tokens before they expire
6. Launch the session picker so you can start working immediately

What Gets Installed

| 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 |

Both are installed only if not already present. Existing installations are preserved.

What Gets Persisted

Everything is stored in a single .replit-tools/ directory:

| Data | Location | Survives Restart? |
|------|----------|-------------------|
| Claude conversations | .replit-tools/.claude-persistent/ | Yes |
| Claude credentials | .replit-tools/.claude-persistent/ | Yes |
| Claude binary | .replit-tools/.claude-versions/ | Yes |
| Codex data | .replit-tools/.codex-persistent/ | Yes |
| Bash history | .replit-tools/.persistent-home/ | Yes |
| Per-terminal sessions | .replit-tools/.claude-sessions/ | Yes |
| Auth logs | .replit-tools/.logs/ | Yes |
| Scripts | .replit-tools/scripts/ | Yes |

Automatic Token Refresh

Claude OAuth tokens expire every 8-12 hours. DATA Tools automatically refreshes them:

- On every shell start: Checks token expiry and refreshes if < 2 hours remaining
- When expired: Attempts automatic refresh using the stored refresh token
- Transparent: You'll see 🔄 Token expires in 1h, refreshing... then ✅ Token refreshed (11h remaining)

This means you can leave overnight and come back to a working session - no more claude login every morning.

$3

`bash


Check token status

/home/runner/workspace/.replit-tools/scripts/claude-auth-refresh.sh --status

Force refresh now

/home/runner/workspace/.replit-tools/scripts/claude-auth-refresh.sh --force

Or use a permanent API token (never expires)

claude setup-token
`

The Session Picker

After installation (and on every new shell), you'll see:

`
✅ Claude authentication: valid (11h remaining)
✅ Claude Code ready: 2.0.71 (Claude Code)

╭─────────────────────────────────────────────────────────╮
│ Claude Session Manager │
╰─────────────────────────────────────────────────────────╯
(2 Claude instance(s) running in other terminals)

[c] Continue last session for this terminal
└─ b3dcb95c...
[r] Resume a specific session (pick from list)
[n] Start new session
[s] Skip - just give me a shell

Choice [c/r/n/s]: _
`

$3

Press r to see full session metadata:

`
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[1]
ID: b3dcb95c-cebb-4082-b671-988c8d36578e
Messages: 237 | Size: 912.1KB
Active: 2m ago
Started: 2026-01-18 18:22:12 UTC
First: "Can you help me fix this bug..."
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 installer creates symlinks from ephemeral locations to persistent .replit-tools/ storage:

`
~/.claude → .replit-tools/.claude-persistent/
~/.codex → .replit-tools/.codex-persistent/
~/.local/share/claude/versions/ → .replit-tools/.claude-versions/
~/.local/bin/claude → .replit-tools/.claude-versions/X.X.X
`

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 .replit-tools/scripts/ (called by above)

Smart Detection

The installer checks for:

- CLAUDE_CONFIG_DIR - Respects custom Claude config directory if set in Replit Secrets
- CODEX_HOME - Respects custom Codex config directory
- Existing persistent config - Uses your existing config if present (won't migrate if custom dir set)
- 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

$3

Claude Code:

| Variable | Purpose |
|----------|---------|
| CLAUDE_CONFIG_DIR | Custom directory for Claude config/data |
| CLAUDE_WORKSPACE_DIR | Alternative name (both are valid) |
| CLAUDE_DATA_DIR | Alternative name |
| CLAUDE_HOME | Alternative name |
| ANTHROPIC_API_KEY | Claude API authentication |

OpenAI Codex CLI:

| Variable | Purpose |
|----------|---------|
| CODEX_HOME | Custom directory for Codex config/data (official) |
| CODEX_CONFIG_DIR | Alternative name |
| CODEX_DATA_DIR | Alternative name |
| OPENAI_API_KEY | Codex API authentication |

If you set these in your Replit Secrets to paths inside /home/runner/workspace/, DATA Tools will use those directories for persistence instead of the defaults. Your custom directories will NOT be migrated - we respect your configuration.

Installation Options

$3

`bash
npx -y replit-tools
`

$3

`bash
curl -fsSL https://raw.githubusercontent.com/stevemoraco/DATAtools/main/install.sh | bash
`

$3

`bash
npm install -g replit-tools
replit-tools
`

Commands

After installation, these aliases are available:

| Command | Description |
|---------|-------------|
| cr | Continue last Claude session |
| claude-resume | Same as cr |
| claude-new | Start a new Claude session |
| claude-pick | Claude's built-in session picker |
| cm | Show the session manager menu |
| claude-menu | Same as cm |
| l | Login to Claude (authenticate) |
| claude-login | Same as l |

These aliases work from any shell, even without the session manager loop running.

Configuration

$3

`bash
export CLAUDE_NO_PROMPT=true
`

Add to .config/bashrc to make permanent.

$3

`bash
claude setup-token
`

Creates a long-lived API token that never expires (recommended for unattended use).

Files Created

`
workspace/
├── .replit-tools/ # All DATA Tools data (gitignored)
│ ├── .claude-persistent/ # Claude conversations & credentials
│ ├── .codex-persistent/ # Codex CLI data
│ ├── .claude-sessions/ # Per-terminal session tracking
│ ├── .claude-versions/ # Claude binary versions
│ ├── .persistent-home/ # Bash history
│ ├── .logs/ # Auth refresh logs
│ └── scripts/ # Setup & management scripts
│ ├── setup-claude-code.sh
│ ├── claude-session-manager.sh
│ └── claude-auth-refresh.sh
├── .config/bashrc # Shell startup config (sources scripts)
└── .gitignore # Updated to ignore .replit-tools/
`

Upgrading from v1.x

If you used DATA Tools v1.x (before the .replit-tools/ consolidation), your data will be automatically migrated:

`
Old Location → New Location
.claude-persistent/ → .replit-tools/.claude-persistent/
.codex-persistent/ → .replit-tools/.codex-persistent/
.claude-sessions/ → .replit-tools/.claude-sessions/
.persistent-home/ → .replit-tools/.persistent-home/
.local/share/claude/versions/ → .replit-tools/.claude-versions/
`

Migration only happens if:
1. Old location exists AND new location doesn't
2. You don't have custom CLAUDE_CONFIG_DIR or CODEX_HOME set

Your original data is copied (not moved), so nothing is lost.

Troubleshooting

$3

`bash
source /home/runner/workspace/.replit-tools/scripts/setup-claude-code.sh
`

$3

`bash
source /home/runner/workspace/.config/bashrc
`

$3

The auto-refresh should handle this, but if it fails:

`bash


Check why refresh failed

cat /home/runner/workspace/.replit-tools/.logs/auth-refresh.log

Manual refresh

/home/runner/workspace/.replit-tools/scripts/claude-auth-refresh.sh --force

Or use permanent token (recommended)

claude setup-token
`

$3

`bash
npx -y replit-tools
`

Running the installer again is safe - it preserves existing data.

Security

The installer adds .replit-tools/ to .gitignore, which protects:

| Path | Contains | Why Protected |
|------|----------|---------------|
| .replit-tools/.claude-persistent/ | OAuth tokens, refresh tokens, conversations | Critical - full account access |
| .replit-tools/.codex-persistent/ | API keys in auth.json, conversations | Critical - full account access |
| .replit-tools/.claude-sessions/ | Session UUIDs, terminal mappings | Session metadata |
| .replit-tools/.persistent-home/ | Bash history | May contain typed secrets |
| .replit-tools/.logs/` | Token refresh timestamps | Auth timing info |

Your API keys, OAuth tokens, and conversation history won't be committed to git.

Why "DATA Tools"?

Developer Assistant Tool Automation - everything you need to run AI coding assistants on Replit, persisted and ready to go.

Repository

GitHub: stevemoraco/DATAtools

License

MIT