gibil 0.2.0 → 0.2.1
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 +31 -31
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -15,8 +15,8 @@
|
|
|
15
15
|
</p>
|
|
16
16
|
|
|
17
17
|
<p align="center">
|
|
18
|
-
|
|
19
|
-
|
|
18
|
+
Ephemeral machines for developers and AI agents.<br/>
|
|
19
|
+
Docker, root, SSH, your repo — ready in one command.
|
|
20
20
|
</p>
|
|
21
21
|
|
|
22
22
|
---
|
|
@@ -74,22 +74,22 @@ gibil destroy my-app
|
|
|
74
74
|
|
|
75
75
|
## Commands
|
|
76
76
|
|
|
77
|
-
| Command
|
|
78
|
-
|
|
79
|
-
| `gibil init`
|
|
80
|
-
| `gibil create`
|
|
81
|
-
| `gibil branch <branch>`
|
|
82
|
-
| `gibil checkout <branch>` | Alias for `gibil branch`
|
|
83
|
-
| `gibil ssh <name>`
|
|
84
|
-
| `gibil run <name> <cmd>`
|
|
85
|
-
| `gibil job <cmd>`
|
|
86
|
-
| `gibil exec <name>`
|
|
87
|
-
| `gibil mcp [name]`
|
|
88
|
-
| `gibil list`
|
|
89
|
-
| `gibil extend <name>`
|
|
90
|
-
| `gibil destroy [name]`
|
|
91
|
-
| `gibil auth`
|
|
92
|
-
| `gibil usage`
|
|
77
|
+
| Command | Description |
|
|
78
|
+
| ------------------------- | ----------------------------------------------------------- |
|
|
79
|
+
| `gibil init` | Set up gibil — Hetzner token, MCP config, agent skill |
|
|
80
|
+
| `gibil create` | Forge an ephemeral server |
|
|
81
|
+
| `gibil branch <branch>` | Spin up a branch on a clean server (auto-detects repo) |
|
|
82
|
+
| `gibil checkout <branch>` | Alias for `gibil branch` |
|
|
83
|
+
| `gibil ssh <name>` | SSH into a running server |
|
|
84
|
+
| `gibil run <name> <cmd>` | Execute a command remotely (`--background` for async) |
|
|
85
|
+
| `gibil job <cmd>` | Manage background jobs (status, list, cancel, logs) |
|
|
86
|
+
| `gibil exec <name>` | Upload and run a local script |
|
|
87
|
+
| `gibil mcp [name]` | Start MCP server for AI agents (`--print-config` for setup) |
|
|
88
|
+
| `gibil list` | List all active servers |
|
|
89
|
+
| `gibil extend <name>` | Extend a server's TTL |
|
|
90
|
+
| `gibil destroy [name]` | Burn down a server |
|
|
91
|
+
| `gibil auth` | Manage authentication |
|
|
92
|
+
| `gibil usage` | View usage and plan limits |
|
|
93
93
|
|
|
94
94
|
## Two Ways to Use Agents
|
|
95
95
|
|
|
@@ -102,11 +102,11 @@ gibil create --name my-app --repo github.com/you/project
|
|
|
102
102
|
gibil mcp # Claude Code gets vm_bash, vm_read, vm_write tools
|
|
103
103
|
```
|
|
104
104
|
|
|
105
|
-
| Pros
|
|
106
|
-
|
|
107
|
-
| See everything the agent does
|
|
108
|
-
| Agent uses your local config
|
|
109
|
-
| Works with any MCP-compatible agent | Long commands block with no streaming
|
|
105
|
+
| Pros | Cons |
|
|
106
|
+
| ----------------------------------- | ------------------------------------------ |
|
|
107
|
+
| See everything the agent does | Every file/command is a network round-trip |
|
|
108
|
+
| Agent uses your local config | Your laptop stays busy (fans, battery) |
|
|
109
|
+
| Works with any MCP-compatible agent | Long commands block with no streaming |
|
|
110
110
|
|
|
111
111
|
### Option B: Agent on the server (--agent)
|
|
112
112
|
|
|
@@ -125,12 +125,12 @@ gibil branch feat/payments --agent aider # then: export ANTHROPIC_API_KEY=..
|
|
|
125
125
|
gibil branch feat/payments --agent codex # then: export OPENAI_API_KEY=...
|
|
126
126
|
```
|
|
127
127
|
|
|
128
|
-
| Pros
|
|
129
|
-
|
|
130
|
-
| Direct filesystem — no MCP latency | Need to SSH in to interact
|
|
131
|
-
| Full Docker, real Linux tools
|
|
132
|
-
| Your laptop is free
|
|
133
|
-
| Works with claude, aider, codex
|
|
128
|
+
| Pros | Cons |
|
|
129
|
+
| ---------------------------------- | ------------------------------ |
|
|
130
|
+
| Direct filesystem — no MCP latency | Need to SSH in to interact |
|
|
131
|
+
| Full Docker, real Linux tools | Set API key manually after SSH |
|
|
132
|
+
| Your laptop is free | Need tmux to persist sessions |
|
|
133
|
+
| Works with claude, aider, codex | |
|
|
134
134
|
|
|
135
135
|
> **Security note:** Don't pass API keys via `--env` — they end up on disk in `/etc/environment`. Instead, SSH in and `export` the key. It stays in memory and vanishes when the server is destroyed.
|
|
136
136
|
|
|
@@ -150,9 +150,9 @@ gibil branch feat/payments --run "pnpm dev" --port 3000
|
|
|
150
150
|
Or with an interactive SSH session and port forwarding:
|
|
151
151
|
|
|
152
152
|
```bash
|
|
153
|
-
gibil ssh feat-payments --port 3000 --port
|
|
153
|
+
gibil ssh feat-payments --port 3000 --port 8080
|
|
154
154
|
# → Forwarding localhost:3000 → feat-payments:3000
|
|
155
|
-
# → Forwarding localhost:
|
|
155
|
+
# → Forwarding localhost:8080 → feat-payments:8080
|
|
156
156
|
# → Tunnel active while SSH session is open
|
|
157
157
|
```
|
|
158
158
|
|