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.
Files changed (2) hide show
  1. package/README.md +56 -59
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,94 +1,91 @@
1
1
  <p align="center">
2
- <img src="logo.png" width="200" alt="Gibil" />
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">Ephemeral dev compute for humans and AI agents. CLI-first, no UI required.</p>
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
- ## Quick Start
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
- pnpm install
23
- pnpm build
33
+ npm install -g gibil
24
34
  ```
25
35
 
26
- ## Usage
36
+ ## Forge. Run. Burn.
27
37
 
28
38
  ```bash
29
- # Create a VM
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
- # SSH into it
33
- gibil ssh my-app
42
+ # Let your agent work on it
43
+ gibil run my-app "pnpm install && pnpm test"
34
44
 
35
- # Run a command
36
- gibil run my-app "pnpm test"
45
+ # Or give Claude Code direct access via MCP
46
+ gibil mcp my-app
37
47
 
38
- # Destroy when done
48
+ # Burn it when done
39
49
  gibil destroy my-app
40
50
  ```
41
51
 
42
- AI agents can use `--json` for machine-readable output.
52
+ ## Why Gibil?
43
53
 
44
- ## Dev
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
- ```bash
47
- pnpm dev -- create --name my-app --json
48
- pnpm test
49
- pnpm test:watch
50
- pnpm build
51
- ```
60
+ ## Commands
52
61
 
53
- ## Test Tracker
54
-
55
- | Suite | File | Status |
56
- |-------|------|--------|
57
- | Unit | `config-parser.test.ts` | Passing |
58
- | Unit | `logger.test.ts` | Passing |
59
- | Unit | `auth.test.ts` | Passing |
60
- | Unit | `cli.test.ts` | Passing |
61
- | Unit | `cloud-init.test.ts` | Passing |
62
- | Unit | `hetzner.test.ts` | Passing |
63
- | Unit | `mcp.test.ts` | Passing |
64
- | Unit | `paths.test.ts` | Passing |
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
- ```bash
77
- # Login (one-time)
78
- npm login
75
+ ## Agent Workflow
76
+
77
+ Every command supports `--json`. Agents forge, run, and burn — no human in the loop.
79
78
 
80
- # Build, verify contents, publish
81
- pnpm build
82
- npm pack --dry-run # check what will be included
83
- npm publish
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
- Only `dist/`, `LICENSE`, `README.md`, and `package.json` are published. Source code stays private.
85
+ ## License
86
+
87
+ Proprietary. See [LICENSE](LICENSE) for details.
87
88
 
88
- ## Environment
89
+ ---
89
90
 
90
- | Variable | Required | Description |
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>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gibil",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Ephemeral dev compute for humans and AI agents",
5
5
  "type": "module",
6
6
  "bin": {