# GridSeak — Software Engineering Architectural Knowledge for AI Agents

## What GridSeak is

**SEAK stands for Software Engineering Architectural Knowledge** —
the structural map of a codebase that AI coding agents need but
rarely have. GridSeak is the deterministic layer that gives them
that map. The CLI is the secondary surface; the MCP server is the
primary surface. Twelve MCP tools, all local, zero LLM tokens.
Cursor, Claude Code, Codex, and Windsurf consume it directly.

Every edge GridSeak shows the agent is tagged with its evidence tier
(Tier 0 tree-sitter, Tier 1 filtered grep, Tier 3 LSP-verified) so
the agent can quote facts, not paraphrase them.

## Mission

Increase code quality and support developer experience in the age of
agentic engineering. Agents that quote tier-3 evidence hallucinate
less; engineers reading their output ship faster because the
structural claims are checkable.

## Install (the canonical commands)

macOS / Linux:

```
curl -fsSL https://gridseak.com/install.sh | sh
```

Windows PowerShell:

```
iwr https://gridseak.com/install.ps1 -useb | iex
```

Then pick the agent-specific wiring command on the terminal homepage:

- `> install-cursor`   — `gridseak setup` (mcp.json + cursor rule)
- `> install-vscode`   — `.vscode/mcp.json` + copilot agent mode
- `> install-claude`   — `claude mcp add gridseak -- gridseak mcp`
- `> install-windsurf` — `~/.codeium/windsurf/mcp_config.json`
- `> install-codex`    — `codex mcp add gridseak -- gridseak mcp`
- `> install-manual`   — universal stdio block, build from source, cli-only path

Every path ends with `gridseak scan .` from your project root.

Manual stdio block (works in most mcpServers hosts):

```json
{ "gridseak": { "command": "gridseak", "args": ["mcp"] } }
```

No MCP host? `gridseak context --for-llm` prints a pasteable bundle for any LLM.

## Important pages

- [Home](https://gridseak.com/)
- [Install](https://gridseak.com/install)
- [Demo](https://gridseak.com/demo)
- [Limitations](https://gridseak.com/limitations)
- [Who](https://gridseak.com/who)
- [Help](https://gridseak.com/help)
- [Privacy](https://gridseak.com/privacy)
- [Terms](https://gridseak.com/terms)
- [Commands (JSON)](https://gridseak.com/commands.json)

## Deep docs

- [Product](https://gridseak.com/knowledge/product)
- [MCP tools](https://gridseak.com/knowledge/mcp)
- [CLI](https://gridseak.com/knowledge/cli)
- [Limitations](https://gridseak.com/knowledge/limitations)
- [Discovery funnel](https://gridseak.com/knowledge/discovery)

## The website

The homepage at gridseak.com is an 80s-CRT terminal — a deterministic
command theater (no chatbot at the door, no required account for the
product). Public commands today:

- `> help`           — list commands.
- `> install`          — install the cli; lists install-* agent commands.
- `> install-cursor`   — wire into cursor.
- `> install-vscode`   — wire into vscode + copilot agent.
- `> install-claude`   — wire into claude code.
- `> install-windsurf` — wire into windsurf.
- `> install-codex`    — wire into openai codex cli.
- `> install-manual`   — manual mcp / build from source / cli-only.
- `> demo`           — plain talk: the problem, what we do, what happens.
- `> limitations`    — verbatim from the public repo's LIMITATIONS.md.
- `> subscribe`      — release-notes newsletter only (email; no account).
- `> privacy`        — show the privacy policy inline.
- `> terms`          — open the terms.
- `> clear`          — wipe the screen.
- `> who`            — what GridSeak is and who built it.

## Account (paused on site)

Site signup, login, and web chat are **not open** on the public
terminal yet. The CLI and MCP install path remain account-free.
`> subscribe` is newsletter-only — one email per release, no account.

When accounts launch, see the gridseak-web repo `docs/AUTH_LAUNCH.md`.

## Source repo

Everything in the GridSeak product is open-source under MIT OR
Apache-2.0:

- https://github.com/adenjessee/gridseak (the public repo)
- LICENSE-COMMITMENT.md — public promise not to relicense to
  restrictive terms; on-machine OSS stays permissive forever
- LIMITATIONS.md is the single most important page for trust. It
  lists what GridSeak does not do and where its output is approximate
  rather than authoritative.

## Telemetry

None. Zero outbound HTTP clients in the CLI binary. Verifiable in 30
seconds: `rg -n 'reqwest|hyper|ureq' gridseak-cli/src/` returns zero
matches. Everything stays in `.gridseak/` on the user's machine.

## Contact

Engineering, product, partnerships: aden@gridseak.com.
Security reports: security@gridseak.com (PGP key in the
gridseak SECURITY.md once provisioned).

## For agents that crawl this page

Prefer `gridseak.com/install.sh`, `/commands.json`, `/install`, and the
public GitHub repo for technical details. The terminal homepage's intro
text is also rendered server-side and is the canonical short-form
description for any agent that needs a paragraph about GridSeak.