io.github.AlexikM/gibil

NPM · GIBIL · SCANNED AUG 3

Spawns an ephemeral Ubuntu VM with project clone, shell exec, file I/O, and auto-destroy on TTL.

Available components

+44 this week 62 62 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (105 of 109), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (105 of 109), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency6

Repository check failed: the declared repository URL returned HTTP 404. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
License check failed: the license (FSL-1.1-Apache-2.0) isn't a recognized OSI-approved license. See how to fix → Fail
Actively maintained (last published 27 days ago).Pass
Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1322 tokens (~101/item across 13 items; 13 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · gibil

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add alexikm-gibil -- npx -y gibil

# add to Codex CLI

codex mcp add alexikm-gibil -- npx -y gibil

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "alexikm-gibil": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "gibil"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add alexikm-gibil --command npx --arg -y --arg gibil

# ~/.hermes/config.yaml

mcp_servers:
  alexikm-gibil:
    command: "npx"
    args: ["-y", "gibil"]

// mcp.json

{
  "mcpServers": {
    "alexikm-gibil": {
      "command": "npx",
      "args": [
        "-y",
        "gibil"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +42
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- License: unverified → fail ▼ functional
- Schema quality: unverified → excellent ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: FSL-1.1-Apache-2.0 functional
1 Aug 26 −6
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
28 Jul 26 +22
- Tool coverage: unverified → 100 ▲ functional
- First check of Schema quality: fail functional
- First check of Schema quality: pass functional
- First check of Schema quality: unverified functional
- First check of Tool coverage: 100 functional
27 Jul 26 18

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 105 packages

105 packages in the resolved dependency tree · 105 deprecated · 34 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 13 exposed · ~1,322 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

create_server ~488

Forge a new ephemeral server with a full Linux environment (Ubuntu 24.04, Node.js 20, pnpm). Clones the repo to /root/project and waits until fully provisioned. Optionally checks out a branch and installs a coding agent (claude, aider, codex) so the server can run agent tasks directly. Picks the configured default provider unless 'provider' is set (hetzner, vultr). After creation, use vm_bash to run commands, vm_read/vm_write for files, vm_grep to search code. Destroy with destroy_server when done.

Input Output Examples

Name	Type	Req	Description
agent	string	—	Coding agent to install on the server. One of: claude, aider, codex. Forward its API key via 'env' (e.g. ANTHROPIC_API_KEY for claude, OPENAI_API_KEY for codex).
branch	string	—	Git branch to check out after the repo is cloned. Requires 'repo'.
env	object	—	Environment variables to set on the server
location	string	—	Provider region. Hetzner: fsn1/nbg1/ash. Vultr: nrt/sgp/syd/icn/bom.
name	string	—	Server name (auto-generated if omitted)
provider	string	—	Cloud provider (default: configured default — hetzner if unset). vultr gives APAC regions.
repo	string	—	Git repo URL to clone on boot
server_type	string	—	Provider-native SKU (overrides size). Hetzner: cax11/cax21/cax31 (ARM, fsn1/nbg1) or cpx21/cpx31 (x86). Vultr: vc2-2c-4gb/vc2-4c-8gb.
size	string	—	Gibil size: small (2 vCPU/4 GB), medium (4 vCPU/8 GB), large (8 vCPU/16 GB). Resolved per provider — see gibil providers.
ttl	number	—	Auto-destroy after N minutes (default: 60, max 525600 = 1 year). Common values: 1440 (1d), 10080 (7d), 43200 (1mo), 525600 (1y)

No output schema declared.

No examples provided.

destroy_server ~54

Burn a server. Deletes the Hetzner VM, SSH keys, and local metadata. Always destroy servers when done to avoid costs. Works on expired instances too.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Name of the server to destroy

No output schema declared.

No examples provided.

extend_server ~108

Extend a server's TTL. Resets the auto-destroy timer. Supports long-lived durations up to 1 year.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Server name
ttl	number	yes	New TTL in minutes from now (max 525600 = 1 year). Common values: 1440 (1d), 10080 (7d), 43200 (1mo), 129600 (3mo), 259200 (6mo), 525600 (1y)

No output schema declared.

No examples provided.

list_servers ~25

List all active gibil servers with their names, IPs, and remaining TTL.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

vm_bash ~149

Run a shell command on a remote server. Default working directory is /root/project. Use for: installing deps, running tests, git operations, builds. For commands over 2 minutes, set background=true to get a job_id you can poll with vm_job_status.

Input Output Examples

Name	Type	Req	Description
background	boolean	—	Run in background, return job ID for polling
command	string	yes	Shell command to execute
server	string	—	Server name (auto-selects if only one is running)
timeout_ms	number	—	Timeout in ms (default: 120000). Increase for long builds or test suites.
working_dir	string	—	Working directory (default: /root/project)

No output schema declared.

No examples provided.

vm_grep ~96

Search for a pattern in files on a remote server. Uses ripgrep if available, falls back to grep.

Input Output Examples

Name	Type	Req	Description
include	string	—	File glob to include (e.g. '*.ts')
path	string	—	Directory or file to search (default: /root/project)
pattern	string	yes	Regex pattern to search for
server	string	—	Server name (auto-selects if only one is running)

No output schema declared.

No examples provided.

vm_job_list ~37

List all background jobs across all servers. Read-only — does not modify job state. Use vm_sweep_orphans to mark dead jobs.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

vm_job_status ~53

Check the status of a background job started with vm_bash(background=true). Returns status, exit code, and output when done.

Input Output Examples

Name	Type	Req	Description
job_id	string	yes	Job ID returned by vm_bash with background=true

No output schema declared.

No examples provided.

vm_ls ~68

List files and directories on a remote server.

Input Output Examples

Name	Type	Req	Description
glob	string	—	Glob pattern to filter (e.g. '*/.ts')
path	string	—	Directory path (default: /root/project)
server	string	—	Server name (auto-selects if only one is running)

No output schema declared.

No examples provided.

vm_read ~89

Read a file from a remote server. Returns the file contents with line numbers.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Max lines to return
offset	integer	—	Start at line N (1-based)
path	string	yes	Absolute path on the server (e.g. /root/project/src/app.ts)
server	string	—	Server name (auto-selects if only one is running)

No output schema declared.

No examples provided.

vm_stats ~50

Get server resource usage — CPU cores, load average, memory, disk, and uptime. Returns structured data for monitoring.

Input Output Examples

Name	Type	Req	Description
server	string	—	Server name (auto-selects if only one is running)

No output schema declared.

No examples provided.

vm_sweep_orphans ~35

Mark running jobs as orphaned if their server no longer exists. Use after destroy_server to clean up lingering job records.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

vm_write ~70

Write content to a file on a remote server. Creates parent directories if needed. Overwrites existing files.

Input Output Examples

Name	Type	Req	Description
content	string	yes	File content to write
path	string	yes	Absolute path on the server
server	string	—	Server name (auto-selects if only one is running)

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug