[FEATURE] Claude Code Mobile Companion App

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

Claude Code runs exclusively in a desktop terminal environment. When I step away from my computer while Claude is working on a task, I have no way to:

• See if Claude is waiting for my input
• Check progress on longer tasks
• Quickly approve or reject suggestions
• Continue a paused session

My workflow is delegation-based: I discuss a problem with Claude, make a decision, then let Claude work autonomously while I do other things. This works great when I'm at my desk, but the moment I leave, I'm completely disconnected.

Current workarounds are impractical:

• SSH apps on mobile require too much typing
• vscode.dev on a phone screen is cramped and clunky
• There's no notification system to alert me when Claude needs input

I don't need to write code on my phone. I need to monitor and interact with Claude Code sessions - approve, reject, continue, stop. That's it.

Proposed Solution

A lightweight "Claude Code Companion" mobile app for iOS/Android focused on three things:

1. Monitoring

• See active sessions and their current status (running/waiting/finished/error)
• View Claude's output in a scrollable, readable format
• Optionally expand to see changed files or details

2. Interaction

• Text input for natural language instructions
• Quick action buttons: Continue, Stop, Approve, Reject, Commit, Test
• Draggable divider to adjust output vs. input area ratio

3. Notifications

• Push notification when Claude needs input
• Push notification when a task completes
• Actionable notifications (respond without opening the app)

What this is NOT:

• Not a full IDE or code editor
• Not a file browser
• Not a replacement for the desktop experience

Ideal UI:

• Top: Scrollable output area showing Claude's responses
• Middle: Draggable divider
• Bottom: Text input + quick action buttons
• Status indicator showing session state

Alternative Solutions

_No response_

Priority

Medium - Would be very helpful

Feature Category

Interactive mode (TUI)

Use Case Example

Scenario: Delegating a refactoring task before leaving the house

1. At my desktop, I start Claude Code and say: "Analyze the auth module and suggest security improvements."

1. Claude begins analyzing. I need to leave for an appointment.

1. On my commute, I get a push notification:

"Claude Code: Session 'my-project' needs input - Found 3 issues in auth module. Should I fix them?"

1. I open the companion app and see Claude's full analysis:

• Issue 1: Password hashing uses MD5 (critical)
• Issue 2: No rate limiting on login
• Issue 3: Session tokens don't expire

1. I tap the text input and type: "Fix #1 and #2, skip #3 for now"

1. Claude continues working. I put my phone away.

1. 10 minutes later, another notification:

"Claude Code: Changes ready. 2 files modified. Commit?"

1. I tap [Approve] directly on the notification without opening the app.

1. When I get home, the work is done and committed.

Time saved: Instead of waiting at my desk or coming back to a stalled session, I stayed productive and kept Claude moving - all from my phone with minimal interaction.

Additional Context

UI Mockup

Main View

┌─────────────────────────────────────┐
│ ● Claude Code          [Session 1] │
├─────────────────────────────────────┤
│                                     │
│  Claude: I've analyzed the auth     │
│  module. Found 3 issues:            │
│                                     │
│  1. Password hashing uses MD5       │
│  2. No rate limiting on login       │
│  3. Session tokens don't expire     │
│                                     │
│  Should I fix these?                │
│                                     │
│  ▼ [Show changed files]             │
│                                     │
├─────────────────════════════════════┤
│                                     │
│  > Fix #1 and #2, skip #3           │
│                                     │
│  [Send]                             │
├─────────────────────────────────────┤
│ [Continue] [Stop] [Approve] [Commit]│
└─────────────────────────────────────┘

Notification

┌─────────────────────────────────────┐
│ 🔵 Claude Code                      │
│ Session needs input                 │
│ "Should I refactor auth.py or..."   │
│                                     │
│ [View] [Continue] [Stop]            │
└─────────────────────────────────────┘

Similar Features in Other Tools

• GitHub Mobile - Review PRs, approve/reject, respond to comments on the go
• Slack Mobile - Conversation-first interface, actionable notifications
• Linear Mobile - Manage tasks and issues without full desktop experience

Technical Considerations

Connection Options:

1. Relay server (like VS Code Tunnels) - works through NAT/firewalls
2. Direct P2P via Tailscale/WireGuard - no relay needed
3. Hybrid approach - direct when possible, relay as fallback

Required Changes to Claude Code CLI:

• Background daemon mode for persistent sessions
• WebSocket/API endpoint for remote control
• Push notification trigger integration
• Session state serialization for reconnection

Additional Ideas

• Gesture support: Swipe right to approve, swipe left to reject
• Voice input: For longer instructions when typing is inconvenient
• Home screen widget: Glanceable status ("Running task 3/5" or "Waiting for input")
• Watch app (future): Apple Watch / WearOS for notifications + quick actions only

---

tl;dr: Let me check on Claude and tell it "yes" or "no" from my phone. That's it. That's the feature.