Getting started with Linkitty
Linkitty connects your own Coding agents, websites and APIs. Projects, sessions and model sign-in remain on your computer. The platform processes account, authorization and connection metadata. A trusted HTTPS gateway can read the content it forwards. Keep your computer awake and online, with the business application and Linkitty background service running.
Choose your system
| System | Availability | Prerequisites |
| macOS Apple Silicon | Desktop ZIP and paired CLI tarballs released | Node.js 22+, your own agent and model sign-in |
| Linux | User-level systemd integration implemented; native packages not released or verified | Node.js 22+, agent and working user-level systemd; macOS packages cannot be used |
| Windows | User task integration implemented; native packages not released or verified | Node.js 22+, PowerShell and agent; macOS packages cannot be used |
| Android ARM64 | Management App APK released | Sign in to the same account and install Coding from the plugin marketplace |
| iOS / other architectures | Not released | Use only artifacts actually offered on the download page |
Download at linkitty.spark-data.cn. Files come from Alibaba Cloud OSS; verify SHA256SUMS.txt. The current macOS app is ad-hoc signed and not notarized. Keep system security protections enabled.
Connect on macOS
Download the matching linkitty and linkitty-desktop tarballs and install both with the command on the website. Public npm registry publication remains deferred. Then run:
linkitty --lang en
linkitty --region cn
linkitty login
linkitty connect codex
Before the first Codex connection, finish your task and exit independently running Codex. After connecting, open Codex normally to continue native sessions on computer or phone. No daily shared-control launcher is needed, and no project is bound by default. Use linkitty connect codex -qr to claim the service from your phone instead.
linkitty connect pi --executable /absolute/path/to/pi
linkitty connect claude --profile /absolute/private/claude/profile.json
linkitty connect dsh --profile /absolute/private/deepseek/profile.json
linkitty connect web 127.0.0.1:8080
Pi uses its existing local environment. Claude and DSH use existing protected profiles. Each runtime manages its own model sign-in and tool permissions. Codex desktop session sharing currently supports macOS only. See the English CLI guide / 中文.
Continue on phone or desktop
Sign in to the same China account, install Coding from the marketplace, choose a connected service under My Services, then select a project and session. Output, tasks, queued messages and approvals remain subject to runtime capabilities and authorization. Sharing grants explicit usage rights without transferring management, credentials or onward-sharing rights.
Region and language
The China endpoint is https://cn.linkitty.spark-data.cn/gateway. The existing https://112.124.32.189/gateway remains available; adding a domain does not move or erase existing accounts and bindings. Singapore and the United States are not open yet. Never send sign-in data to unverified endpoints.
Change App language on the sign-in or account page. Use CLI --lang zh|en|ja|ru or LINKITTY_LANG. Language does not change the account region. Local account, configuration and runtime data are stored under ~/.linkitty/; desktop and CLI share preferences. Never package or commit that directory.
Pause or delete
linkitty disconnect ID pauses a connection. linkitty service uninstall stops the background service and keeps configuration. linkitty delete INSTANCE_ID --yes permanently deletes service registration and sharing grants while retaining projects, native sessions and computer files. Verify the selected service before permanent deletion.