gibil 0.1.0 → 0.1.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 +56 -59
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,94 +1,91 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="
|
|
2
|
+
<img src="https://i.imgur.com/oAzmG6R.png" width="200" alt="Gibil" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
5
|
<h1 align="center">Gibil</h1>
|
|
6
6
|
|
|
7
|
-
<p align="center">
|
|
7
|
+
<p align="center"><strong>Full servers. Forged in seconds. Gone when done.</strong></p>
|
|
8
8
|
|
|
9
9
|
<p align="center">
|
|
10
|
-
<img src="https://img.shields.io/badge/tests-99%20passed-brightgreen" alt="Tests: 99 passed" />
|
|
11
|
-
<img src="https://img.shields.io/badge/test%20files-14%20passed-brightgreen" alt="Test files: 14 passed" />
|
|
12
|
-
<img src="https://img.shields.io/badge/vitest-v4.1.0-yellow" alt="Vitest v4.1.0" />
|
|
13
10
|
<img src="https://img.shields.io/badge/version-0.1.0-blue" alt="Version 0.1.0" />
|
|
11
|
+
<img src="https://img.shields.io/badge/tests-99%20passing-brightgreen" alt="Tests: 99 passing" />
|
|
12
|
+
<img src="https://img.shields.io/badge/typescript-%3E5.0-3178C6" alt="TypeScript" />
|
|
13
|
+
<img src="https://img.shields.io/badge/node-%3E%3D20-339933" alt="Node >= 20" />
|
|
14
14
|
<img src="https://img.shields.io/badge/license-proprietary-red" alt="License: Proprietary" />
|
|
15
15
|
</p>
|
|
16
16
|
|
|
17
|
+
<p align="center">
|
|
18
|
+
Your localhost wasn't built for AI agents.<br/>
|
|
19
|
+
Gibil forges real servers so your agents stop fighting for your machine.
|
|
20
|
+
</p>
|
|
21
|
+
|
|
17
22
|
---
|
|
18
23
|
|
|
19
|
-
##
|
|
24
|
+
## The Problem
|
|
25
|
+
|
|
26
|
+
You're running Claude Code, Cursor, or custom agents — and they're all competing for your localhost. Your laptop fans are screaming. Your ports are clashing. Your agent just `rm -rf`'d something it shouldn't have.
|
|
27
|
+
|
|
28
|
+
Your agents need their own machines. That's gibil.
|
|
29
|
+
|
|
30
|
+
## Install
|
|
20
31
|
|
|
21
32
|
```bash
|
|
22
|
-
|
|
23
|
-
pnpm build
|
|
33
|
+
npm install -g gibil
|
|
24
34
|
```
|
|
25
35
|
|
|
26
|
-
##
|
|
36
|
+
## Forge. Run. Burn.
|
|
27
37
|
|
|
28
38
|
```bash
|
|
29
|
-
#
|
|
39
|
+
# Forge a server with your repo cloned and ready
|
|
30
40
|
gibil create --name my-app --repo github.com/you/project --ttl 30
|
|
31
41
|
|
|
32
|
-
#
|
|
33
|
-
gibil
|
|
42
|
+
# Let your agent work on it
|
|
43
|
+
gibil run my-app "pnpm install && pnpm test"
|
|
34
44
|
|
|
35
|
-
#
|
|
36
|
-
gibil
|
|
45
|
+
# Or give Claude Code direct access via MCP
|
|
46
|
+
gibil mcp my-app
|
|
37
47
|
|
|
38
|
-
#
|
|
48
|
+
# Burn it when done
|
|
39
49
|
gibil destroy my-app
|
|
40
50
|
```
|
|
41
51
|
|
|
42
|
-
|
|
52
|
+
## Why Gibil?
|
|
43
53
|
|
|
44
|
-
|
|
54
|
+
- **Your agent gets its own server** — no more sharing localhost. Forge a machine, hand it to Claude, let it work.
|
|
55
|
+
- **MCP built in** — `gibil mcp <name>` gives Claude Code direct access to a remote server. Your agent builds, tests, and deploys without touching your machine.
|
|
56
|
+
- **Ephemeral by design** — set a TTL, servers auto-destroy. No forgotten VMs, no surprise bills.
|
|
57
|
+
- **Safe isolation** — every server is a fresh machine. Agent breaks something? Burn it and forge a new one.
|
|
58
|
+
- **Parallel agents** — forge 5 servers, run 5 agents, destroy them all. Scale your AI workflow, not your hardware.
|
|
45
59
|
|
|
46
|
-
|
|
47
|
-
pnpm dev -- create --name my-app --json
|
|
48
|
-
pnpm test
|
|
49
|
-
pnpm test:watch
|
|
50
|
-
pnpm build
|
|
51
|
-
```
|
|
60
|
+
## Commands
|
|
52
61
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
|
56
|
-
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
|
63
|
-
|
|
|
64
|
-
|
|
|
65
|
-
| Unit | `random.test.ts` | Passing |
|
|
66
|
-
| Unit | `ssh-keys.test.ts` | Passing |
|
|
67
|
-
| Unit | `store.test.ts` | Passing |
|
|
68
|
-
| Unit | `validate.test.ts` | Passing |
|
|
69
|
-
| Integration | `full-pipeline.test.ts` | Passing |
|
|
70
|
-
| Integration | `mock-provider.test.ts` | Passing |
|
|
71
|
-
|
|
72
|
-
**99 tests across 14 files — all passing.**
|
|
73
|
-
|
|
74
|
-
## Publishing to npm
|
|
62
|
+
| Command | Description |
|
|
63
|
+
|---------|-------------|
|
|
64
|
+
| `gibil create` | Forge an ephemeral server |
|
|
65
|
+
| `gibil ssh <name>` | SSH into a running server |
|
|
66
|
+
| `gibil run <name> <cmd>` | Execute a command remotely |
|
|
67
|
+
| `gibil exec <name>` | Upload and run a local script |
|
|
68
|
+
| `gibil mcp <name>` | Connect Claude Code to a server |
|
|
69
|
+
| `gibil list` | List all active servers |
|
|
70
|
+
| `gibil extend <name>` | Extend a server's TTL |
|
|
71
|
+
| `gibil destroy [name]` | Burn down a server |
|
|
72
|
+
| `gibil auth` | Manage authentication |
|
|
73
|
+
| `gibil usage` | View usage and plan limits |
|
|
75
74
|
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
75
|
+
## Agent Workflow
|
|
76
|
+
|
|
77
|
+
Every command supports `--json`. Agents forge, run, and burn — no human in the loop.
|
|
79
78
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
79
|
+
```bash
|
|
80
|
+
gibil create --name task --repo https://github.com/user/repo --json --ttl 30
|
|
81
|
+
gibil run task "cd /root/project && pnpm install && pnpm test" --json
|
|
82
|
+
gibil destroy task --json
|
|
84
83
|
```
|
|
85
84
|
|
|
86
|
-
|
|
85
|
+
## License
|
|
86
|
+
|
|
87
|
+
Proprietary. See [LICENSE](LICENSE) for details.
|
|
87
88
|
|
|
88
|
-
|
|
89
|
+
---
|
|
89
90
|
|
|
90
|
-
|
|
91
|
-
|----------|----------|-------------|
|
|
92
|
-
| `HETZNER_API_TOKEN` | Yes | For VM operations |
|
|
93
|
-
| `GIBIL_API_KEY` | No | For authenticated usage / metering |
|
|
94
|
-
| `GIBIL_API_URL` | No | Override Supabase Edge Functions URL |
|
|
91
|
+
<p align="center"><sub>Named after the Sumerian god of fire. The oldest flame, forging the newest servers.</sub></p>
|