MCPcopy
hub / github.com/slopus/happy

github.com/slopus/happy @cli-1.1.10 sqlite

repository ↗ · DeepWiki ↗ · release cli-1.1.10 ↗
4,200 symbols 14,230 edges 1,028 files 431 documented · 10%
README
<img src="https://github.com/slopus/happy/raw/cli-1.1.10/github/logotype-dark.png" width="400" alt="Happy">

Mobile and Web Client for Claude Code & Codex

Use Claude Code or Codex from anywhere with end-to-end encryption.

📱 iOS App🤖 Android App🌐 Web App🎥 See a Demo📚 Documentation💬 Discord

github

Step 1: Download App

appstore     googleplay

Step 2: Install CLI on your computer

npm install -g happy

Migrated from the happy-coder package. Thanks to @franciscop for donating the happy package name!

Step 3: Start using `happy` instead of `claude` or `codex`

# Instead of claude, use:
happy claude
# or
happy codex

How does it work?

On your computer, run happy instead of claude or happy codex instead of codex to start your AI through our wrapper. When you want to control your coding agent from your phone, it restarts the session in remote mode. To switch back to your computer, just press any key on your keyboard.

🔥 Why Happy Coder?

  • 📱 Mobile access to Claude Code and Codex - Check what your AI is building while away from your desk
  • 🔔 Push notifications - Get alerted when Claude Code and Codex needs permission or encounters errors
  • Switch devices instantly - Take control from phone or desktop with one keypress
  • 🔐 End-to-end encrypted - Your code never leaves your devices unencrypted
  • 🛠️ Open source - Audit the code yourself. No telemetry, no tracking

📦 Project Components

  • Happy App - Web UI + mobile client (Expo)
  • Happy CLI - Command-line interface for Claude Code and Codex
  • Happy Agent - Remote agent control CLI (create, send, monitor sessions)
  • Happy Server - Backend server for encrypted sync

🏠 Who We Are

We're engineers scattered across Bay Area coffee shops and hacker houses, constantly checking how our AI coding agents are progressing on our pet projects during lunch breaks. Happy Coder was born from the frustration of not being able to peek at our AI coding tools building our side hustles while we're away from our keyboards. We believe the best tools come from scratching your own itch and sharing with the community.

📚 Documentation & Contributing

License

MIT License - see LICENSE for details.

Extension points exported contracts — how you extend this code

Encryptor (Interface)
(no doc) [6 implementers]
packages/happy-app/sources/sync/encryption/encryptor.ts
Plugin (Interface)
(no doc) [6 implementers]
packages/codium/sources/plugins/types.ts
AcpPermissionHandler (Interface)
(no doc) [4 implementers]
packages/happy-cli/src/agent/acp/AcpBackend.ts
EnvironmentConfig (Interface)
(no doc)
environments/environments.ts
StartServerOptions (Interface)
(no doc)
packages/happy-server/sources/index.ts
Decryptor (Interface)
(no doc) [6 implementers]
packages/happy-app/sources/sync/encryption/encryptor.ts
CodexSessionState (Interface)
(no doc) [5 implementers]
packages/codium/sources/boot/main/agent-worker/worker.ts
TransportHandler (Interface)
(no doc) [3 implementers]
packages/happy-cli/src/agent/transport/TransportHandler.ts

Core symbols most depended-on inside this repo

expect
called by 4248
packages/happy-app/sources/dev/testRunner.ts
toBe
called by 1857
packages/happy-app/sources/dev/testRunner.ts
t
called by 965
packages/happy-app/sources/text/index.ts
log
called by 849
packages/happy-app/sources/log.ts
debug
called by 811
packages/happy-cli/src/ui/logger.ts
push
called by 791
packages/codium/sources/boot/main/agent-worker/worker.ts
toEqual
called by 711
packages/happy-app/sources/dev/testRunner.ts
send
called by 204
packages/codium/sources/agents/agent-bridge.ts

Shape

Function 2,692
Method 786
Interface 529
Class 190
Enum 3

Languages

TypeScript100%
Go1%

Modules by API surface

packages/happy-cli/src/codex/codexAppServerClient.ts54 symbols
packages/happy-app/sources/sync/ops.ts52 symbols
packages/happy-app/sources/sync/storage.ts49 symbols
environments/environments.ts48 symbols
packages/happy-cli/src/api/apiSession.ts44 symbols
packages/codium/sources/boot/main/happy-worker/worker.ts42 symbols
packages/happy-cli/src/claude/utils/sessionProtocolMapper.ts38 symbols
packages/happy-cli/src/agent/acp/runAcp.ts37 symbols
packages/happy-app/sources/sync/persistence.ts37 symbols
packages/happy-cli/src/utils/tmux.ts36 symbols
packages/happy-cli/src/agent/acp/AcpBackend.ts35 symbols
packages/happy-server/sources/app/events/eventRouter.ts34 symbols

Dependencies from manifests, versioned

@agentclientprotocol/sdk0.14.1 · 1×
@anthropic-ai/claude-agent-sdk0.3.179 · 1×
@anthropic-ai/claude-code2.1.143 · 1×
@anthropic-ai/sandbox-runtime0.0.37 · 1×
@anthropic-ai/sdk0.96.0 · 1×
@babel/core7.25.2 · 1×
@codemirror/lang-cpp6.0.3 · 1×
@codemirror/lang-css6.3.1 · 1×
@codemirror/lang-go6.0.1 · 1×
@codemirror/lang-html6.4.11 · 1×
@codemirror/lang-java6.0.2 · 1×
@codemirror/lang-javascript6.2.5 · 1×

Datastores touched

happyDatabase · 1 repos
dbDatabase · 1 repos

For agents

$ claude mcp add happy \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact