whatisgithub

What is cccompanion?

cybersealnull/cccompanion — explained in plain English

Analysis updated 2026-05-18

★ 31SwiftAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

An unofficial iOS app that lets you use Claude Code remotely from your iPhone via your own Mac.

Mindmap

mindmap
  root((CcCompanion))
    What it does
      Chat with Claude Code
      Remote terminal view
      Slash commands
    Tech stack
      SwiftUI
      Python server
      Tailscale
    Use cases
      Start coding tasks remotely
      Monitor long AI tasks
      Local first setup
    Audience
      Claude Code users
      iOS developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Send coding requests to Claude Code on your Mac from your iPhone.

USE CASE 2

Check on a long-running AI coding task without sitting at your computer.

USE CASE 3

View a live terminal feed of what Claude Code is doing on your Mac.

USE CASE 4

Run multiple Claude Code sessions and switch between them with slash commands.

What is it built with?

SwiftSwiftUIPythonTailscale

How does it compare?

cybersealnull/cccompanionpylogmon/istartbleeeet/termipet
Stars313133
LanguageSwiftSwiftSwift
Setup difficultyhardmoderateeasy
Complexity4/52/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires a Mac with Claude Code installed, Xcode to build the app, and a network like Tailscale linking the phone and Mac.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

CcCompanion is an unofficial open-source iOS app that lets you use Claude Code, an AI coding assistant that normally runs in a terminal on your Mac, from your iPhone, wherever you are. It has two pieces: a SwiftUI iPhone app and a small Python server that runs on your Mac. When you send a message from your iPhone, the server relays it to Claude Code running in a terminal session on your Mac, captures the reply, and pushes it back to your phone via push notifications. The whole setup is local-first, meaning your messages never pass through any third-party cloud, your Mac talks directly to your iPhone over a private network like Tailscale, ZeroTier, or your home Wi-Fi. The iPhone app supports chat with history and search, a terminal view to see what Claude is doing, and slash commands for managing sessions. You would use this if you want to kick off coding tasks from your phone or check on a long-running AI task without sitting at your computer. It requires a Mac with Claude Code installed and an iPhone running iOS 18 or later.

Copy-paste prompts

Prompt 1
Walk me through setting up the apns-server on my Mac for CcCompanion.
Prompt 2
Explain how CcCompanion relays messages between my iPhone and Claude Code without a cloud server.
Prompt 3
Help me build the CcCompanion iOS app from source in Xcode.
Prompt 4
Show me how to use slash commands like /new and /switch in CcCompanion.

Frequently asked questions

What is cccompanion?

An unofficial iOS app that lets you use Claude Code remotely from your iPhone via your own Mac.

What language is cccompanion written in?

Mainly Swift. The stack also includes Swift, SwiftUI, Python.

What license does cccompanion use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is cccompanion to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is cccompanion for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?