<h1 align="center"AI Coding Agent for Your Terminal</h1
<p align="center" AI coding agent for your terminal — built for <strongdevelopers</strong, not teams or enterprises (yet). </p
<p align="center" <a href="https://golang.org/"<img src="https://img.shields.io/badge/Go-1.26+-00ADD8?style=flat-square&logo=go&logoColor=white" alt="Go"</a <a href="LICENSE"<img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"</a <a href="https://github.com/GrayCodeAI/hawk/actions/workflows/ci.yml"<img src="https://img.shields.io/github/actions/workflow/status/GrayCodeAI/hawk/ci.yml?style=flat-square&label=tests" alt="CI"</a <a href="https://github.com/GrayCodeAI/hawk/releases"<img src="https://img.shields.io/github/v/release/GrayCodeAI/hawk?style=flat-square&label=release&color=green" alt="Release"</a <a href="https://pkg.go.dev/github.com/GrayCodeAI/hawk"<img src="https://img.shields.io/badge/godoc-reference-00ADD8?style=flat-square&logo=go" alt="GoDoc"</a </p
<p align="center" <a href="#quick-start"Quick Start</a · <a href="#features"Features</a · <a href="#usage"Usage</a · <a href="#skills"Skills</a · <a href="#tools"Tools</a · <a href="#architecture"Architecture</a · <a href="#contributing"Contributing</a </p
---
Why hawk
hawk is an AI-powered coding agent that lives in your terminal. It reads your codebase, writes and edits files, runs tests, and manages git — all through natural language. Unlike IDE-bound tools, hawk works over SSH, in containers, and on any machine with a shell.
Developer path: one machine, keychain credentials, local memory. Run hawk path to check readiness.
- Model-agnostic — works with Claude, GPT-4, Gemini, DeepSeek, Ollama, and 75+ models through eyrie
- Zero CGO — single static binary, cross-compiled for linux/darwin/windows on amd64/arm64
- Privacy-first — your code never leaves your machine except to the LLM API you choose
- Extensible — 40+ built-in tools, MCP server support, community skill registry
Status
Hawk is in active development. Contributor source builds are the primary path today while we keep hardening the product in the open. Tagged releases and install assets may exist for validation, but they are not the recommended first path yet.
Follow GrayCode for progress. When Hawk is ready to try, we will announce it on graycodeai.com.
Quick Start (contributors — from source)
git clone https://github.com/GrayCodeAI/hawk && cd hawk
make setup # clones required support repos into external/ and syncs go.work
go build -o hawk ./cmd/hawk
./hawk
# First run — paste API key in /config (stored in macOS Keychain / Linux keyring)
# Verify readiness
./hawk pathSee docs/SECURITY-DEVELOPER.md for the credential model. Do not put API keys in shell env or .env for hawk.
Optional for contributors:
go install github.com/GrayCodeAI/hawk/cmd/hawk@latest