How do I install happy?

Run these in Claude Code: npx -y skills add slopus/happy --agent claude-code. Then prompt normally.

Does happy auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

happy

Mobile and Web client for Codex and Claude Code, with realtime voice, encryption and fully featured

FLOW.md

slopus@slopus

GitHub

Plugin Signal74/100Solid

maintained99

capable34

documented75

adopted93

Install

$ npx -y skills add slopus/happy --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

TypeScript Bash GitHub Anthropic iOS

+1 tag

Android

23,250

Stars

1,967

Forks

Active

Maintenance

TypeScript

Language

MIT

License

2d ago

Last commit

1y ago

Created

Repo: slopus/happy

In this plugin

2 skills 1 agent 1 MCP

skills
- agent-browser
- terminal-emulator
agents
- i18n-translator
MCP
- paper

See everything inside

What's inside

npm install -g happy

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

# 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

Documentation Website - Learn how to use Happy Coder effectively
Contributing Guide - How to contribute, PR guidelines, and development setup
Edit docs at github.com/slopus/slopus.github.io - Help improve our documentation and guides

License

MIT License - see LICENSE for details.

File tree

1802

slopus/happyView on GitHub

.agents/
  agents/
    triage-issues-and-prs.md
  skills/
    agent-browser/
      SKILL.md
    control-flow/
      SKILL.md
    dev/
      SKILL.md
    maintain/
      checkpoint.md
      SKILL.md
    metrics-graphana/
      SKILL.md
    office-hours/
      SKILL.md
    release/
      SKILL.md
    sessions/
      scripts/
        discover-sessions.sh
        extract-errors.py
        extract-metadata.py
        extract-skeleton.py
      SKILL.md
    terminal-emulator/
      SKILL.md
.claude/
  launch.json
  settings.json
  skills/
    agent-browser/
      SKILL.md
    control-flow
    maintain
    metrics-graphana
    release
    sessions
    terminal-emulator/
      SKILL.md
.codex/
  config.toml
.dockerignore
.github/
  header.png
  logotype-dark.png
  logotype-light.png
  mascot.png
  workflows/
    cli-smoke-test.yml
    server.yml
    typecheck.yml
.gitignore
.mcp.json
.npmrc
AGENTS.md
Dockerfile
Dockerfile.server
Dockerfile.webapp
docs/
  3dparty.md
  api.md
  backend-architecture.md
  cli-architecture.md
  competition/
    AGENTS.md
    claude/
      message-protocol.md
      README.md
      sources.md
    codex/
      message-protocol.md
      README.md
      sources.md
    comparison-matrix.md
    opencode/
      message-protocol.md
      README.md
      runtime-tracing.md
      sources.md
      trace-opencode.sh
    superset/
      electric-sql.md
      README.md
      sources.md
      sync-architecture.md
      terminal-sync.md
  CONTRIBUTING.md
  current-community.md
  deployment.md
  dev-environments.md
  encryption.md
  experimental/
    agents-engineer.md
    agents-manager.md
    agents.md
    product.md
    roadmap.md
  happy-wire.md
  layout-core.md
  multi-process.md
  paid-voice.md
  permission-resolution.md
  plans/
    agent-sdk-upgrade-plan-mode-fix.md
    agent-testing-layers.md
    cli-v3-messages-api.md
    codex-app-server-migration.md
    elevenlabs-voice-usage-gating.md
    experimental-chat-file-links.md
    expo-sdk-55-upgrade.md
    generic-acp-runner.md
    happy-agent.md
    happy-serve-self-host.md
    metadata-driven-model-mode-selection.md
    pnpm-migration [draft].md
    portable-binary.md
    provider-envelope-redesign.md
    reliable-http-messages-api.md
    remove-profiles-wizard-cli-detection.md
    sandbox-runtime.md
    session-protocol-impl.md
    session-protocol-unification-v2-draft.md
    session-protocol-v2.md
    tauri-desktop-packaging.md
  product-analytics.md
  protocol.md
  README.md
  realtime-sync-and-rpc.md
  research/
    agent-teams-claude-code-stuck-non-interactive.png
    agent-teams-claude-code.md
    unsupervised-development-guidelines-and-skills.md
  roadmap.md
  session-protocol-claude.md
  session-protocol.md
  superpowers/
    plans/
      2026-05-20-new-session-right-sidebar.md
      2026-06-10-attachment-storage-diagnostics.md
      2026-06-10-codex-image-attachments.md
    specs/
      2026-05-20-new-session-right-sidebar-design.md
      2026-06-10-attachment-storage-diagnostics-design.md
      2026-06-10-codex-image-attachments-design.md
  user-identity.md
  voice-architecture.md
environments/
  .gitignore
  environments.ts
  lab-rat-todo-project/
    agents.md
    app.js
    CLAUDE.md
    exercise-flow.md
    index.html
    README.md
    styles.css
  snapshots/
    .gitkeep
LICENSE
logo.png
package.json
packages/
  codium/
    .gitignore
    design-system.md
    electron.vite.config.ts
    package.json
    sources/
      agents/
        agent-bridge.ts
        catalog.ts
      app/
        chat/
          ChatsPersistence.tsx
          runner.ts
          store.ts
        components/
          AccountPopover.css
          AccountPopover.tsx
          ArchivedChatRow.css
          ArchivedChatRow.tsx
          AttachButton.css
          AttachButton.tsx
          AttachmentChip.css
          AttachmentChip.tsx
          AutomationTemplateCard.css
          AutomationTemplateCard.tsx
          chat/
            AssistantMessage.css
            AssistantMessage.tsx
            PermissionPrompt.css
            PermissionPrompt.tsx
            UserMessage.css
            UserMessage.tsx
          ColorSwatch.css
          ColorSwatch.tsx
          Composer.css
          Composer.tsx
          ComposerEditor.tsx
          ComposerOptions.css
          ComposerOptions.tsx
          ContextRing.css
          ContextRing.tsx
          EffortPicker.tsx
          MainSidebar.css
          MainSidebar.tsx
          MenuSeparator.css
          MenuSeparator.tsx
          ModelEffortPicker.tsx
          ModelPicker.tsx
          OptionCard.css
          OptionCard.tsx
          Page.css
          Page.tsx
          PluginCatalogCard.css
          PluginCatalogCard.tsx
          SearchDialog.css
          SearchDialog.tsx
          SearchSurface.css
          SearchSurface.tsx
          SegmentedControl.css
          SegmentedControl.tsx
          SelectButton.css
          SelectButton.tsx
          SettingsRow.css
          SettingsRow.tsx
          SettingsShellPreview.css
          SettingsShellPreview.tsx
          SettingsSidebar.css
          SettingsSidebar.tsx
          SidebarResizer.css
          SidebarResizer.tsx
          terminal/
            TerminalHost.css
            TerminalHost.tsx
            TerminalPane.css
            TerminalPane.tsx
          TerminalPreview.css
          TerminalPreview.tsx
          ThemePicker.css
          ThemePicker.tsx
          ThemeSwitcher.css
          ThemeSwitcher.tsx
          ToggleSwitch.css
          ToggleSwitch.tsx
          Toolbar.css
          Toolbar.tsx
          UsageLimitSection.css
          UsageLimitSection.tsx
          WorkspaceTabs.css
          WorkspaceTabs.tsx
        layouts/
          MainLayout.css
          MainLayout.tsx
          RootLayout.css
          RootLayout.tsx
          SettingsLayout.tsx
        pages/
          Chat.css
          Chat.tsx
          Components.css
          Components.tsx
          NewChat.css
          NewChat.tsx
          NewProject.css
          NewProject.tsx
          PluginDetail.tsx
          Plugins.css
          Plugins.tsx
          settings/
            About.tsx
            Appearance.tsx
            General.tsx
        routes.tsx
        state.ts
        workspace/
          store.ts
      boot/
        main/
          agent-worker/
            codex-cli.test.ts
            codex-cli.ts
            host.ts
            worker.ts
          app-storage.test.ts
          app-storage.ts
          chat-store.ts
          codex-oauth.ts
          happy-worker/
            host.ts
            worker.ts
          index.ts
          worktree-names.test.ts
          worktree-names.ts
        preload/
          index.d.ts
          index.ts
      env.d.ts
      happy/
        client.ts
      index.css
      index.html
      main.tsx
      plugins/
        agent-bridge.ts
        anthropic/
          index.ts
        codex/
          index.ts
        happy/
          index.ts
        host.ts
        index.ts
        types.ts
      providers.tsx
      shared/
        agent-protocol.ts
        happy-protocol.ts
      theme/
      theme.ts
        __tests__/
          codex-snapshots.json
          codex-themes.json
          derive.test.ts
        derive.ts
        index.ts
        presets.ts
        types.ts
    tsconfig.json
    tsconfig.node.json
    tsconfig.web.json
    vitest.config.ts
  happy-agent/
    .release-it.json
    .release-it.notes.js
    bin/
      happy-agent.mjs
    package.json
    README.md
    src/
      api.test.ts
      api.ts
      auth.test.ts
      auth.ts
      cli-smoke.test.ts
      config.test.ts
      config.ts
      credentials.test.ts
      credentials.ts
      encryption.test.ts
      encryption.ts
      happy-agent.integration.test.ts
      index.test.ts
      index.ts
      machineRpc.ts
      output.test.ts
      output.ts
      session.test.ts
      session.ts
    tsconfig.json
    vitest.config.ts
    vitest.integration.config.ts
  happy-app/
  happy-app-logs/
    package.json
    src/
      server.ts
    tsconfig.json
    .claude/
      agents/
        i18n-translator.md
      settings.json
    .eas/
      workflows/
        ota.yaml
        preview.yaml
    .gitignore
    .vscode/
      launch.json
    app.config.js
    babel.config.js
    CHANGELOG.md
    CLAUDE.md
    deploy/
      happy-app.yaml
    docs/
      marketing/
        README-creators.md
    eas.json
    google-services.json
    index.ts
    LICENSE
    logo.png
    metro.config.js
    nativewind-env.d.ts
    package.json
    patches/
... 1600 more

Showing a partial view of a very large repo.

FAQ

happy is a Claude Code plugin with 2 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes agent-browser, terminal-emulator. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is happy?: Mobile and Web client for Codex and Claude Code, with realtime voice, encryption and fully featured
How do I install happy?: Run these in Claude Code: npx -y skills add slopus/happy --agent claude-code. Then prompt normally.
Does happy auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is happy free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

🔥 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

🏠 Who We Are

.agents/ agents/ triage-issues-and-prs.md skills/ agent-browser/ SKILL.md control-flow/ SKILL.md dev/ SKILL.md maintain/ checkpoint.md SKILL.md metrics-graphana/ SKILL.md office-hours/ SKILL.md release/ SKILL.md sessions/ scripts/ discover-sessions.sh extract-errors.py extract-metadata.py extract-skeleton.py SKILL.md terminal-emulator/ SKILL.md .claude/ launch.json settings.json skills/ agent-browser/ SKILL.md control-flow maintain metrics-graphana release sessions terminal-emulator/ SKILL.md .codex/ config.toml .dockerignore .github/ header.png logotype-dark.png logotype-light.png mascot.png workflows/ cli-smoke-test.yml server.yml typecheck.yml .gitignore .mcp.json .npmrc AGENTS.md Dockerfile Dockerfile.server Dockerfile.webapp docs/ 3dparty.md api.md backend-architecture.md cli-architecture.md competition/ AGENTS.md claude/ message-protocol.md README.md sources.md codex/ message-protocol.md README.md sources.md comparison-matrix.md opencode/ message-protocol.md README.md runtime-tracing.md sources.md trace-opencode.sh superset/ electric-sql.md README.md sources.md sync-architecture.md terminal-sync.md CONTRIBUTING.md current-community.md deployment.md dev-environments.md encryption.md experimental/ agents-engineer.md agents-manager.md agents.md product.md roadmap.md happy-wire.md layout-core.md multi-process.md paid-voice.md permission-resolution.md plans/ agent-sdk-upgrade-plan-mode-fix.md agent-testing-layers.md cli-v3-messages-api.md codex-app-server-migration.md elevenlabs-voice-usage-gating.md experimental-chat-file-links.md expo-sdk-55-upgrade.md generic-acp-runner.md happy-agent.md happy-serve-self-host.md metadata-driven-model-mode-selection.md pnpm-migration [draft].md portable-binary.md provider-envelope-redesign.md reliable-http-messages-api.md remove-profiles-wizard-cli-detection.md sandbox-runtime.md session-protocol-impl.md session-protocol-unification-v2-draft.md session-protocol-v2.md tauri-desktop-packaging.md product-analytics.md protocol.md README.md realtime-sync-and-rpc.md research/ agent-teams-claude-code-stuck-non-interactive.png agent-teams-claude-code.md unsupervised-development-guidelines-and-skills.md roadmap.md session-protocol-claude.md session-protocol.md superpowers/ plans/ 2026-05-20-new-session-right-sidebar.md 2026-06-10-attachment-storage-diagnostics.md 2026-06-10-codex-image-attachments.md specs/ 2026-05-20-new-session-right-sidebar-design.md 2026-06-10-attachment-storage-diagnostics-design.md 2026-06-10-codex-image-attachments-design.md user-identity.md voice-architecture.md environments/ .gitignore environments.ts lab-rat-todo-project/ agents.md app.js CLAUDE.md exercise-flow.md index.html README.md styles.css snapshots/ .gitkeep LICENSE logo.png package.json packages/ codium/ .gitignore design-system.md electron.vite.config.ts package.json sources/ agents/ agent-bridge.ts catalog.ts app/ chat/ ChatsPersistence.tsx runner.ts store.ts components/ AccountPopover.css AccountPopover.tsx ArchivedChatRow.css ArchivedChatRow.tsx AttachButton.css AttachButton.tsx AttachmentChip.css AttachmentChip.tsx AutomationTemplateCard.css AutomationTemplateCard.tsx chat/ AssistantMessage.css AssistantMessage.tsx PermissionPrompt.css PermissionPrompt.tsx UserMessage.css UserMessage.tsx ColorSwatch.css ColorSwatch.tsx Composer.css Composer.tsx ComposerEditor.tsx ComposerOptions.css ComposerOptions.tsx ContextRing.css ContextRing.tsx EffortPicker.tsx MainSidebar.css MainSidebar.tsx MenuSeparator.css MenuSeparator.tsx ModelEffortPicker.tsx ModelPicker.tsx OptionCard.css OptionCard.tsx Page.css Page.tsx PluginCatalogCard.css PluginCatalogCard.tsx SearchDialog.css SearchDialog.tsx SearchSurface.css SearchSurface.tsx SegmentedControl.css SegmentedControl.tsx SelectButton.css SelectButton.tsx SettingsRow.css SettingsRow.tsx SettingsShellPreview.css SettingsShellPreview.tsx SettingsSidebar.css SettingsSidebar.tsx SidebarResizer.css SidebarResizer.tsx terminal/ TerminalHost.css TerminalHost.tsx TerminalPane.css TerminalPane.tsx TerminalPreview.css TerminalPreview.tsx ThemePicker.css ThemePicker.tsx ThemeSwitcher.css ThemeSwitcher.tsx ToggleSwitch.css ToggleSwitch.tsx Toolbar.css Toolbar.tsx UsageLimitSection.css UsageLimitSection.tsx WorkspaceTabs.css WorkspaceTabs.tsx layouts/ MainLayout.css MainLayout.tsx RootLayout.css RootLayout.tsx SettingsLayout.tsx pages/ Chat.css Chat.tsx Components.css Components.tsx NewChat.css NewChat.tsx NewProject.css NewProject.tsx PluginDetail.tsx Plugins.css Plugins.tsx settings/ About.tsx Appearance.tsx General.tsx routes.tsx state.ts workspace/ store.ts boot/ main/ agent-worker/ codex-cli.test.ts codex-cli.ts host.ts worker.ts app-storage.test.ts app-storage.ts chat-store.ts codex-oauth.ts happy-worker/ host.ts worker.ts index.ts worktree-names.test.ts worktree-names.ts preload/ index.d.ts index.ts env.d.ts happy/ client.ts index.css index.html main.tsx plugins/ agent-bridge.ts anthropic/ index.ts codex/ index.ts happy/ index.ts host.ts index.ts types.ts providers.tsx shared/ agent-protocol.ts happy-protocol.ts theme/ theme.ts __tests__/ codex-snapshots.json codex-themes.json derive.test.ts derive.ts index.ts presets.ts types.ts tsconfig.json tsconfig.node.json tsconfig.web.json vitest.config.ts happy-agent/ .release-it.json .release-it.notes.js bin/ happy-agent.mjs package.json README.md src/ api.test.ts api.ts auth.test.ts auth.ts cli-smoke.test.ts config.test.ts config.ts credentials.test.ts credentials.ts encryption.test.ts encryption.ts happy-agent.integration.test.ts index.test.ts index.ts machineRpc.ts output.test.ts output.ts session.test.ts session.ts tsconfig.json vitest.config.ts vitest.integration.config.ts happy-app/ happy-app-logs/ package.json src/ server.ts tsconfig.json .claude/ agents/ i18n-translator.md settings.json .eas/ workflows/ ota.yaml preview.yaml .gitignore .vscode/ launch.json app.config.js babel.config.js CHANGELOG.md CLAUDE.md deploy/ happy-app.yaml docs/ marketing/ README-creators.md eas.json google-services.json index.ts LICENSE logo.png metro.config.js nativewind-env.d.ts package.json patches/ ... 1600 more

happy

Skills

Agents

MCP

README

How does it work?

🔥 Why Happy Coder?

📦 Project Components

🏠 Who We Are

📚 Documentation & Contributing

License

File tree

happy

Skills

Agents

MCP

README

How does it work?

🔥 Why Happy Coder?

📦 Project Components

🏠 Who We Are

📚 Documentation & Contributing

License

File tree