# Groundwire

> A Bitcoin computing stack built on Urbit. Personal server with built-in SPV wallet, Nostr client, and MCP server for AI agents.

Groundwire is a sovereign computing platform that combines Urbit's peer-to-peer OS with Bitcoin-native identity and payments. It replaces Urbit's Ethereum-based ID system with Bitcoin ordinal inscriptions, giving users a self-hosted personal server networked via Bitcoin addresses.

## Key Components

- **Urbit Personal Server**: A full virtual computer on a P2P network, free from gatekeepers
- **SPV Wallet**: Bitcoin light client derived from the Urbit master ticket
- **Nostrill**: Urbit-native Nostr social client for censorship-resistant communication
- **MCP Server**: Model Context Protocol server for AI agent integration (Claude Code, OpenCode, Codex)
- **Landscape**: Urbit's home screen with app management
- **Groups**: Self-hosted group chat and channels

## Install

Requires Linux (x86_64 or aarch64) or macOS (Apple Silicon). ~2 GB RAM, ~1 GB disk.

```
curl -fsSL https://groundwire.io/install.sh | sh
```

## Status

Alpha release — uses real Bitcoin but identities are not yet expected to be permanent.

## Pages

- [Guide](/guide.html): Installation walkthrough, quickstart, master ticket setup, troubleshooting
- [AI Integration](/ai.html): MCP server setup for Claude Code, OpenCode, and Codex. Available tools: get-file, insert-file, list-files, commit-desk, build-file, scry, poke-our-agent, run-tests, new-desk, mount-desk, install-app, nuke-agent, revive-agent, add-mcp-tool
- [Blog](/blog.html): Project updates

## Links

- GitHub: https://github.com/gwbtc
- Releases: https://github.com/gwbtc/urbit/releases
- Issues: https://github.com/gwbtc/urbit/issues