agentlab 0.2.0 → 0.2.2

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/README.md CHANGED
@@ -1,19 +1,73 @@
1
1
  # AgentLab
2
2
 
3
- One captain for all your coding agents in a fast local terminal UI.
3
+ One captain per project folder, with Codex, Claude Code, and OpenCode in one local terminal.
4
+
5
+ AgentLab lets you switch between projects and run multiple coding-agent sessions while keeping their
6
+ real CLIs accessible. Each project points to a folder on your machine. It has one captain and any
7
+ number of workers.
8
+
9
+ ## Install
4
10
 
5
11
  ```bash
6
12
  npm install --global agentlab
7
13
  agentlab
8
14
  ```
9
15
 
10
- The npm launcher downloads the matching AgentLab executable on first use, verifies its
11
- package-pinned size and SHA-256 digest, and caches it by version. It rechecks the cached digest
12
- before execution. Linux x64 with glibc and Apple-silicon macOS are supported. AgentLab requires
13
- `tmux` and at least one authenticated provider CLI: Codex, Claude Code, or OpenCode.
16
+ Run `agentlab` from any directory. The app opens to the project picker and waits for you to choose a
17
+ folder. On first launch, the npm package downloads the matching AgentLab executable from GitHub and
18
+ caches it. Later launches use the cached executable.
19
+
20
+ ## Requirements
21
+
22
+ - Linux x64 with glibc, or macOS on Apple silicon
23
+ - Node.js 20 or newer
24
+ - `tmux`
25
+ - At least one installed and authenticated provider CLI: `codex`, `claude`, or `opencode`
26
+ - A terminal at least 90 columns by 18 rows
27
+
28
+ Install tmux with `brew install tmux` on macOS or your Linux distribution's package manager.
29
+
30
+ ## Start a project
31
+
32
+ 1. Run `agentlab`.
33
+ 2. Press `Alt+N` and enter the path to an existing folder. The folder can be anywhere on your
34
+ machine.
35
+ 3. Name the project and choose its captain provider, model, and reasoning level.
36
+ 4. Add workers with `Alt+W` when the captain needs more sessions.
37
+ 5. Switch projects from the left sidebar. Each project keeps its captain and workers together.
38
+
39
+ Removing a project stops its managed sessions and forgets it in AgentLab. The project folder and its
40
+ files stay untouched.
41
+
42
+ ## Keys
43
+
44
+ | Key | Action |
45
+ | ------------------------- | --------------------------------------------- |
46
+ | `Alt+1`, `Alt+2`, `Alt+3` | Focus projects, terminal, or agents |
47
+ | `Up`, `Down`, `Enter` | Navigate a focused sidebar and enter terminal |
48
+ | `Alt+N` | Add a project folder |
49
+ | `Alt+W` | Add a worker to the selected project |
50
+ | `Delete` | Remove the selected project or worker |
51
+ | `Alt+C` | Copy the terminal selection |
52
+ | `Alt+Q` | Quit AgentLab |
53
+
54
+ ## Updates
55
+
56
+ AgentLab updates only when you ask it to:
57
+
58
+ ```bash
59
+ agentlab update --check
60
+ agentlab update
61
+ ```
62
+
63
+ Normal startup does not check for updates.
64
+
65
+ ## Local data
14
66
 
15
- Use `agentlab update` for an explicit update or `agentlab update --check` to check without changing
16
- the installation. Normal cached startup performs no update request.
67
+ AgentLab opens no network listener. It stores the project list in a local SQLite database, keeps
68
+ provider credentials in each CLI's existing authentication store, and runs agent sessions through
69
+ tmux.
17
70
 
18
- See [the AgentLab repository](https://github.com/RiadMefti/agentlab) for usage, release checksums,
19
- SBOMs, and build provenance.
71
+ Read the [documentation](https://github.com/RiadMefti/agentlab#readme), browse
72
+ [releases](https://github.com/RiadMefti/agentlab/releases), or
73
+ [report a problem](https://github.com/RiadMefti/agentlab/issues).
package/package.json CHANGED
@@ -1,7 +1,18 @@
1
1
  {
2
2
  "name": "agentlab",
3
- "version": "0.2.0",
4
- "description": "One captain for all your coding agents in a fast local terminal UI.",
3
+ "version": "0.2.2",
4
+ "description": "Run Codex, Claude Code, and OpenCode in one local terminal, with one captain per project.",
5
+ "keywords": [
6
+ "ai",
7
+ "coding-agents",
8
+ "codex",
9
+ "claude-code",
10
+ "opencode",
11
+ "multi-agent",
12
+ "terminal",
13
+ "tui",
14
+ "tmux"
15
+ ],
5
16
  "type": "module",
6
17
  "bin": {
7
18
  "agentlab": "dist/agentlab.js"
@@ -21,12 +32,13 @@
21
32
  "license": "MIT",
22
33
  "repository": {
23
34
  "type": "git",
24
- "url": "git+https://github.com/RiadMefti/agentlab.git"
35
+ "url": "git+https://github.com/RiadMefti/agentlab.git",
36
+ "directory": "packages/launcher"
25
37
  },
26
38
  "bugs": {
27
39
  "url": "https://github.com/RiadMefti/agentlab/issues"
28
40
  },
29
- "homepage": "https://github.com/RiadMefti/agentlab#readme",
41
+ "homepage": "https://github.com/RiadMefti/agentlab",
30
42
  "publishConfig": {
31
43
  "access": "public"
32
44
  }
@@ -2,15 +2,15 @@
2
2
  "repository": "RiadMefti/agentlab",
3
3
  "targets": {
4
4
  "linux-x64": {
5
- "asset": "agentlab-v0.2.0-linux-x64",
6
- "sha256": "7366f538105ba0055d75db54e0a756de975018ca054613e09b0f8572a257beb2",
5
+ "asset": "agentlab-v0.2.2-linux-x64",
6
+ "sha256": "1a0188a0bd416244dbc771d0ad6fff37ec5555c99977cd1607a541c1061708af",
7
7
  "size": 116298952
8
8
  },
9
9
  "mac-arm64": {
10
- "asset": "agentlab-v0.2.0-mac-arm64",
11
- "sha256": "1eafa0a448f2101fe6d7affe56ffe3963d84071737f4cbab14567c819109427f",
10
+ "asset": "agentlab-v0.2.2-mac-arm64",
11
+ "sha256": "0568c53801d701f016006eb89877fd7b1ad7355415bc38928faa3c15bd718aea",
12
12
  "size": 77351282
13
13
  }
14
14
  },
15
- "version": "0.2.0"
15
+ "version": "0.2.2"
16
16
  }