# Hive Run

> Build and run Hive integration tests. Use when you need to test Ethereum clients using Hive's simulation framework.

- Skill: `majiayu000/hive-run` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/hive-run`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/hive-run/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/hive-run

---


# Run Hive Tests

Build Hive and run integration test simulations against Ethereum clients.

## Arguments

- `$0`: Simulator to run (e.g., `ethereum/sync`, `ethereum/rpc`)
- `--client`: Client to test against (e.g., `core-geth`, `go-ethereum`)

## Hive Structure

- Client definitions: `hive/clients/<name>/`
- Simulators: `hive/simulators/<category>/<name>/`
- Clients are Docker containers configured via `HIVE_*` environment variables

## Workflow

1. Navigate to the hive directory
2. Build hive if needed:
   ```bash
   go build .
   ```
3. Run the specified simulator:
   ```bash
   ./hive --sim $0 --client <client>
   ```
4. Report the test results

## Common Simulators

- `ethereum/sync` - Block synchronization tests
- `ethereum/rpc` - JSON-RPC API tests
- `ethereum/consensus` - Consensus mechanism tests

## Example Usage

```
/hive-run ethereum/sync --client core-geth
/hive-run ethereum/rpc --client go-ethereum
```

## Troubleshooting

If tests fail:
1. Check Docker is running and accessible
2. Verify the client image builds successfully
3. Check hive logs in the workspace directory
4. Consult [Hive Documentation](https://github.com/ethereum/hive/tree/master/docs)