codeam-cli 2.39.24 → 2.39.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/README.md +24 -2
- package/dist/index.js +640 -200
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,18 @@ All notable changes to `codeam-cli` are documented here.
|
|
|
4
4
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
6
|
|
|
7
|
+
## [2.39.25] — 2026-06-17
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- **cli:** Self-hosted host-agent supervisor + Docker E2E (#330) (#350)
|
|
12
|
+
|
|
13
|
+
## [2.39.24] — 2026-06-17
|
|
14
|
+
|
|
15
|
+
### Changed
|
|
16
|
+
|
|
17
|
+
- **cli:** Make claude/codex ACP-only; drop legacy PTY parsers + acpDisabled (#349)
|
|
18
|
+
|
|
7
19
|
## [2.39.23] — 2026-06-17
|
|
8
20
|
|
|
9
21
|
### Chore
|
package/README.md
CHANGED
|
@@ -60,6 +60,8 @@ That's it. Open the [CodeAgent Mobile app](https://codeagent-mobile.com), enter
|
|
|
60
60
|
| `codeam deploy` | Provision a cloud workspace (GitHub Codespaces) and pair it to your phone |
|
|
61
61
|
| `codeam deploy ls` (alias `list`) | List the cloud workspaces you've deployed (and which still have a session running) |
|
|
62
62
|
| `codeam deploy stop` (alias `remove`) | Pick a deployed workspace and stop its codeam session (and optionally the workspace itself) |
|
|
63
|
+
| `codeam host enroll --token <token>` | Enroll **this machine** as a self-hosted execution target (the token is minted by the mobile/web app) |
|
|
64
|
+
| `codeam host-agent` | Run the self-hosted supervisor (the enroll step installs this as a systemd service — you rarely call it by hand) |
|
|
63
65
|
| `codeam completion <shell>` | print shell completions for `<shell>` (`bash`, `zsh`, or `fish`) |
|
|
64
66
|
| `codeam --version`, `-v` | Print the installed CLI version |
|
|
65
67
|
| `codeam --help`, `-h` | Show usage and the full command list |
|
|
@@ -98,13 +100,33 @@ codeam deploy stop
|
|
|
98
100
|
|
|
99
101
|
Stopping a workspace via `codeam deploy stop` is non-destructive: the GitHub Codespace stays around (preserving your branch, files, and dotfiles); only the running compute is paused. Re-running `codeam deploy` will offer to resume that same codespace.
|
|
100
102
|
|
|
101
|
-
Adding more cloud backends (Gitpod, Coder,
|
|
103
|
+
Adding more managed cloud backends (Gitpod, Coder, …) is a single new file in `apps/cli/src/services/providers/` — the `CloudProvider` interface keeps it pluggable. To run on **your own server** instead, see the next section.
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## Self-hosted execution plane — run agents on your own server
|
|
108
|
+
|
|
109
|
+
Prefer to run the execution plane on **your own hardware** (a VPS, homelab, or GPU box) instead of a managed Codespace? CodeAgent can provision the same agent runtime on any Linux server you own — with **zero inbound ports, no tunnel, and without ever handing us your SSH keys**. The box only needs outbound internet.
|
|
110
|
+
|
|
111
|
+
**Setup is a one-time paste, driven from the app:**
|
|
112
|
+
|
|
113
|
+
1. In the CodeAgent Mobile app (or web dashboard), open the deploy flow and pick **Self-hosted → Add server**. It shows a one-line install command carrying a short-lived enroll token.
|
|
114
|
+
2. Paste it into an SSH session on your box:
|
|
115
|
+
```bash
|
|
116
|
+
curl -fsSL https://api.codeagent-mobile.com/api/self-hosted/enroll.sh | sh -s -- --token=<enroll-token>
|
|
117
|
+
```
|
|
118
|
+
That installs `codeam-cli`, registers a **systemd** service (`codeam-host-agent`), and connects it back over the same **outbound** relay everything else uses. It survives reboots.
|
|
119
|
+
3. From then on it's **100% phone/web-driven**: pick the host + a repo (or an absolute path on the box) + an agent, and a session spins up on your server — supervised from your phone like any other. Stop sessions or remove the host from the app.
|
|
120
|
+
|
|
121
|
+
Under the hood the installer runs `codeam host enroll` (redeems the token, seals a long-lived host-token to `~/.codeam/host-agent.json`) and starts `codeam host-agent` (the supervisor that spawns a `codeam pair-auto` child per deploy, injecting your linked agent's credentials). You normally never invoke these by hand.
|
|
122
|
+
|
|
123
|
+
> **Deploying to and managing self-hosted servers happens in the mobile/web app, not the CLI.** The CLI's role here is the one-time enrollment plus the long-running host-agent. Requires Linux + systemd.
|
|
102
124
|
|
|
103
125
|
---
|
|
104
126
|
|
|
105
127
|
## Requirements
|
|
106
128
|
|
|
107
|
-
- **Node.js
|
|
129
|
+
- **Node.js 20+**
|
|
108
130
|
- **Claude Code** — see the [official quickstart](https://code.claude.com/docs/en/quickstart)
|
|
109
131
|
- **OpenAI Codex** (optional) — see the [official quickstart](https://github.com/openai/codex)
|
|
110
132
|
- **[CodeAgent Mobile](https://codeagent-mobile.com)** app on your phone ([iOS](https://apps.apple.com/) / [Android](https://play.google.com/store/apps/details?id=com.codeagent.mobile))
|