cconnect
CLAUDE.md6 starsChanged 14 days agoMITView on GitHub
Mobile, desktop and web interface for Claude Code running on the user's PC, over HTTP/WS on the tailnet or publicly through a Tailscale Funnel. Besides the chats it manages the Claude install, the shared folder, the project's git, a browser, a PC monitor, SSH, notes, databases and .ccpack packs, in ten languages; the README lists what each one does. Monorepo with two modules that must stay in sync: - backend/ — FastAPI (Python 3.11+) bridging the app and Claude Code…
- Reads credentials
In this repository2 other files it gives its agents.
- backend/CLAUDE.mdCLAUDE.md
- client/CLAUDE.mdCLAUDE.md
The file
Files
CConnect
Mobile, desktop and web interface for Claude Code running on the user's PC, over HTTP/WS on
the tailnet or publicly through a Tailscale Funnel. Besides the chats it manages the Claude
install, the shared folder, the project's git, a browser, a PC monitor, SSH, notes, databases
and .ccpack packs, in ten languages; the README lists what each one does.
Monorepo with two modules that must stay in sync:
backend/— FastAPI (Python 3.11+) bridging the app and Claude Code through the Agent SDK. THE source of truth for events, schemas and settings. Seebackend/CLAUDE.md.client/— Svelte + Tauri: one codebase → desktop, web and Android. Seeclient/CLAUDE.md.
The client also builds from backend files: the pack format and the built-in packs
(backend/core/packs/), the page icon script (backend/core/scripts/page_icon.js) and the
database file extensions (backend/core/databases/engines.json).
Architecture
[tauri] ──HTTP/WS──> [backend :8723] ──claude-agent-sdk──> [Claude Code CLI]
│
├──> ~/.claude/projects (sessions on disk)
├──> ~/.claude (plugins, MCP, skills, memories)
└──> the data folder (cconnect.db, accounts, shared, packs, trash)The data folder is backend/data in a checkout and ~/.cconnect/data once the package is
installed, with CCONNECT_DATA_DIR above both (core/paths.INSTALLED picks).
Three transport modes: local (both devices on the tailnet, plain HTTP, no auth),
tailnet (cconnect expose tailnet, HTTPS through tailscale serve, still no token
because it never leaves the tailnet) and public (cconnect expose tailscale|caddy,
HTTPS + Authorization: Bearer).
Claude auth is the CLI's own OAuth subscription, never an API key.
The backend ships two ways from one codebase: the cconnect command on PyPI, which the
release workflow publishes on every tag, and a git checkout, where python run.py is the
same entry point. Both take the same commands; see the README.
Version contract
backend/core/release.py declares VERSION, SUPPORTED_APP and SUPPORTED_CLI — the
wheel reads its version from there too; the app carries SUPPORTED_SERVER. /api/health
and /api/capabilities expose all of them and the app renders AppOutdated /
ServerOutdated / CliOutdated notices.
A release is one commit named v<x.y.z> that replaces CHANGELOG.md and bumps five
files: backend/core/release.py (VERSION, and the two floors when they move),
client/package.json, client/src-tauri/Cargo.toml and its
Cargo.lock entry, client/src-tauri/tauri.conf.json (version and
bundle.android.versionCode) and client/vite.config.ts (SUPPORTED_SERVER). Tags are
lightweight and unprefixed (1.6.1). An Android build rewrites the Cargo files
from tauri.conf.json on its own.
A release that only touches the client leaves backend/core/release.py alone, and the
pypi job skips a version PyPI already has. SUPPORTED_SERVER only moves when the app needs
a newer backend.
CHANGELOG.md is replaced whole: no headers, versions or dates, one bullet per
user-visible change written as what the user sees, minor work collapsed into the closing
bullets, and the > [!NOTE] block with the web link at the end.
Development
cd backend && python run.py # local (no reload on Windows: restart by hand)
cd client && npm run check # svelte-check
cd client && npm run devKey rules
- Backend is the source of truth. Mirror its event shapes and field names verbatim; a contract change updates the app in the same commit.
- No comments in any module. Self-explanatory names; a one-line descriptive docstring
only when a constraint cannot be expressed in code. Rationale goes in the answer or the
commit, never in the source. The exception is documentation as data: i18n files and
database
COMMENTs, where it is mandatory. - English for code, docstrings and docs; user-facing strings live in the i18n files.
- No secrets in the repo —
.env,key.properties,keystore.jksandbackend/data/(the database, accounts and your own prompts) are gitignored. - Read before acting — check the existing conventions and helpers before adding new ones.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

