# GrayCode AI

> A place for humans and AI agents to build together.

GrayCode is an open-source AI coding ecosystem for solo developers. Hawk is the primary product and is in active development. Eyrie, Trace, Tok, Yaad, Inspect, and Sight are support capabilities designed to ship behind Hawk. Gitant and Lark are standalone products coming later. Runs locally with your own API keys. MIT licensed.

## Products

### Hawk system (in development)

- **Hawk** — AI coding agent. Docker sandbox by default, model-agnostic, 12,147 community skills planned built-in.
- **Eyrie** — Hawk support capability for LLM runtime with 11 gateways, streaming, retries, and prompt caching.
- **Trace** — Hawk support capability for session capture, checkpoint, and replay.
- **Tok** — Hawk support capability for token compression (60–90% savings).
- **Yaad** — Hawk support capability for graph memory across sessions (MCP server).
- **Inspect** — Hawk support capability for website verification and audit (SARIF output).
- **Sight** — Hawk support capability for code review on diffs.

### Standalone — coming soon

- **Gitant** — Decentralised git for developers and agents.
- **Lark** — Where developers and agents communicate together.

## Status

Hawk does not have a polished public install yet. Contributor builds from source work today. Follow development on GitHub: https://github.com/GrayCodeAI/hawk

## Current contributor workflow

1. Clone Hawk, run `make setup`, and build from source
2. Open Setup: `/config` in the Hawk TUI — add keys, pick a gateway and model
3. Run `hawk path` or `hawk preflight`
4. Use built-in tools and skills: `hawk skills search`, `hawk inspect`, `hawk sight`, etc.

## Architecture

- Go binary — 310K+ lines across the ecosystem repos
- CLI runs locally — your code stays on your machine
- 11 LLM gateways: Anthropic, OpenAI, Gemini, Grok, OpenRouter, Z.AI, CanopyWave, OpenCode Go, Kimi, Xiaomi, Ollama
- MCP-native: Yaad, Sight, and Inspect available as MCP servers
- Skills registry: hawk-community-skills (12k+ skills indexed)

## Pricing

- Nest: Hawk plus built-in support capabilities, 12k+ skills, agents run locally with your keys (free, MIT — when Hawk releases)
- Sync (coming soon): Advanced Tok, unlimited Yaad memory, parallel Inspect, Sight on private repos, usage dashboard
- Weave (coming soon): Full GrayCode line — Hawk + Gitant + Lark

## Links

- Website: https://graycodeai.com
- Docs: https://graycodeai.com/docs
- Vision: https://graycodeai.com/vision
- Blog: https://graycodeai.com/blog
- Changelog: https://graycodeai.com/changelog
- GitHub: https://github.com/GrayCodeAI