VPS Quick Reference

Connecting to the Server

From your Windows Terminal:

ssh [email protected]

Starting Claude Code

Once you're SSH'd in:

cd edgeclaw
claude

This starts a new session every time.

Dangerous Mode (no permission prompts)

claude --dangerously-skip-permissions

Claude won't ask you to approve each action — it just runs. Good for when you want it to work without babysitting.

Force a New Session

claude --new

Use this if Claude keeps resuming an old conversation instead of starting fresh.

Combine Both

claude --dangerously-skip-permissions --new

Accessing the Dashboard (Port Forwarding)

Your work IT blocks the public domain, so you use SSH port forwarding to access the EdgeClaw dashboard locally.

Run this from your local Windows terminal (before SSH'ing in):

ssh -L 8080:localhost:8080 [email protected]

Then open http://localhost:8080/data-status in your browser.

If you just want the tunnel without a shell session, add -N:

ssh -L 8080:localhost:8080 -N [email protected]

Important: Port forwarding dies when that terminal tab closes. You'll need to re-run it each time.

Managing Sessions (tmux)

Your main Claude session runs inside tmux (a tool that keeps terminal sessions alive even when you disconnect).

Reconnect to the Main Session

tmux attach -t claude

Or use the shortcut:

cg

Both do the same thing — bring you back to the main Claude session.

See All Running Sessions

tmux ls

Shows every active tmux session. If you see a bunch piling up, clean them out.

Kill a Specific Session

tmux kill-session -t <name>

Replace <name> with whatever tmux ls shows (e.g., tmux kill-session -t 0).

Kill ALL Sessions (nuclear option)

tmux kill-server

This kills everything including your main session. Use with caution.

Cleanly Exiting Claude Code

Before closing a tab, type inside Claude Code:

/exit

Then type exit to close the SSH connection. This prevents orphaned sessions from piling up.

Running Two Sessions Side by Side

1. Open Tab 1 — SSH in, run claude (or reconnect with cg)
2. Open Tab 2 — SSH in, run claude --dangerously-skip-permissions

Both work in the same folder and share the same memory files. Just avoid editing the same file in both at the same time.

Slash Commands

Custom commands you can type inside Claude Code.

/switch [project]

Saves your current session state, then tells you how to switch to a different project with a clean context window.

Usage:

/switch edgeclaw
/switch ecocell

What it does:

1. Saves everything about your current session to SESSION_STATE.md
2. Tells you to run /clear and then cd into the other project
3. The new project loads its own CLAUDE.md and context — no bleed between projects

Shortcuts: edge or claw for EdgeClaw, eco for EcoCell.

/resume

Picks up where you left off after a /switch or a fresh session.

Usage:

/resume

It reads SESSION_STATE.md in the current folder, shows you what was in progress, and continues from there.

Useful Aliases (already set up)