Server in GitHub Codespaces, without your own computer
Signing in to GitHub, creating, sleeping and waking, and what counts against your quota.
The Server can run in the cloud, in a GitHub Codespace next to a repository you choose. Your computer does not have to be on; the phone connects to the Server running there.
What you need
- A GitHub account and a repository you can write to.
- Free GitHub Codespaces quota. Running time counts against your quota under GitHub's rules.
- Sign-in with the agent's provider (subscription or API key), just as on a computer.
Creating one
In Settings → Codespaces sign in to GitHub, pick a repository and tap Start. The app writes .devcontainer/coden/devcontainer.json to the repository as one commit, saves an encrypted secret for the Server and creates the Codespace. The first start takes a few minutes.
Sleep and wake-up
A Codespace goes to sleep by itself when no phone has been connected for four minutes and the agent is not working. A sleeping Codespace does not use quota. To use it again, tap it in the list and choose Just wake it, or Connect this phone. The app connects as soon as the Server is up.
What gets committed and what stays
Changes the agent makes in a Codespace stay in that Codespace. Until you commit and push them to the repository they can be lost when you delete the Codespace. Deleting a Codespace is always an explicit choice and the app asks first.
Forgetting the connection does not delete the Codespace. It stays in your GitHub account until you delete it on GitHub or in the app.
Stuck somewhere other than what is here? Write to support@coden-app.com.