Pocket IDE 📱💻

Never interrupt your flow again. Code from anywhere - even the bathroom.

🚀 Quick Start

Step 1: Basic Install (5 minutes)

curl -sSL https://raw.githubusercontent.com/H0BB5/pocket-ide/main/install.sh | bash

This gives you:

• ✅ Local network access (connect from phone while at home)
• ✅ Basic commands: pocket status, pocket run 'command'
• ✅ Persistent tmux sessions
• ✅ Works in YOUR current directory (no hardcoded paths!)

Step 2: Enable Remote Access (2 minutes)

Want to code from coffee shops, airports, or anywhere? Add Tailscale:

curl -sSL https://raw.githubusercontent.com/H0BB5/pocket-ide/main/scripts/tailscale-upgrade.sh | bash

This adds:

• 🌐 Access from anywhere with internet
• ⚡ Ultra-short commands: s, r, d (instead of typing long commands)
• 🔐 Secure encrypted connection
• 📱 Better mobile experience
• 🔧 Auto-repair with fix command

📁 Working Directory

Pocket IDE always uses YOUR current directory!

cd ~/my-awesome-project
pocket-ide start      # Creates session in ~/my-awesome-project

cd ~/another-project  
pocket-ide start      # If session exists, keeps using original directory

To work on a different project:

tmux kill-session -t vibecode    # End current session
cd ~/new-project                 # Go to new project
pocket-ide start                 # Start fresh in new directory

📱 Mobile Setup

After installation:

1. Install on your phone:

   • Termius - SSH client
   • Tailscale - If you did Step 2

2. Connect from Termius:

   • Local only: Use your Mac's IP (find with ipconfig getifaddr en0)
   • With Tailscale: Use your hostname (e.g., pocket-mac)

3. Start coding!

   pocket    # Attach to session
   d         # Show dashboard (includes current directory)
   r "create a web app"  # Run command

⚡ Command Reference

After Basic Install

Command	What it does
pocket-ide start	Start/attach to session (in current directory)
pocket status	Check Claude status
pocket run 'cmd'	Send command to Claude

After Tailscale Upgrade (Ultra-Short)

Command	What it does	Example
s	Show status	Just type s
r	Run command	r "build a game"
d	Dashboard (shows current dir)	See everything
c	Clear screen	Clean up
k	Kill process	Stop Claude (smart detection)
1	Go to Claude	Switch panes (from terminal)
2	Go to terminal	Switch panes
p	Next pane	Cycle through
pwd	Show working directory	Check where you are
cd	Change directory in terminal	cd ../other-project
z	Toggle zoom (fullscreen)	Focus on one pane
x	Close current pane	Remove pane
split	Split window	split h or split v
fix	Diagnose & repair	Fix broken sessions
keys	tmux key reference	When shortcuts don't work

🎮 Important: Pane Navigation

When Claude is active, number shortcuts (1,2,3) won't work because input goes to Claude. Instead:

Use tmux native commands:

• Ctrl+b → - Switch to right pane (terminal)
• Ctrl+b ← - Switch to left pane (Claude)
• Ctrl+b q - Show pane numbers, then press number
• Ctrl+b z - Zoom current pane (toggle full screen)

💡 Pro tip: Switch to terminal pane first, then shortcuts work again!

Type keys for full tmux reference.

🔧 Troubleshooting

"can't find pane" errors

Your tmux session structure is broken. Run:

fix    # Diagnose and auto-repair

Can't use shortcuts while Claude is running

• You're in the Claude pane - shortcuts go to Claude
• Use Ctrl+b → to switch to terminal pane
• Or Ctrl+b q then press 2 for terminal
• Now shortcuts work again!

"Claude is idle (nothing to interrupt)"

• The k command detected Claude isn't running anything
• This is normal - Claude is ready for new commands

"sessions should be nested with care"

• You're trying to attach while already in tmux
• Just use pane switching commands instead
• Or exit tmux first with Ctrl+b d

Want to work on a different project?

tmux kill-session -t vibecode    # End current session
cd ~/new-project                 # Navigate to new project
pocket-ide start                 # Start fresh session there

Can't connect from phone?

1. Check SSH is enabled: System Preferences → Sharing → Remote Login
2. If using Tailscale, make sure it's running on both devices
3. Try: ssh username@hostname to test connection

Something really broken?

Nuclear option - full reset:

tmux kill-session -t vibecode
pocket-ide start

🎯 What is Pocket IDE?

Pocket IDE lets you run Claude Code on your Mac and control it from your phone. Perfect for:

• Quick tasks during breaks
• Checking progress while away
• Starting long-running tasks remotely

Your development environment stays persistent in whatever directory you started it - start a task on desktop, check it from your phone, come back to see it completed.

📚 Advanced Guides

• MCP Integration - Connect Claude to your files
• Security Setup - SSH keys and hardening
• Tailscale Details - Deep dive

License

MIT License - see LICENSE file

---

Made with ❤️ for developers who can't stop coding
Even in the bathroom 🚽