Documentation

Start with what
you want to do.

These guides are written for people using or evaluating Blacksite—not only for people who already know AI tooling. Start with a goal below. Technical reference and implementation notes stay available, but they are clearly separated from the everyday path.

Not sure what an “agent loop,” “provider,” or “context window” means? Learn the concepts in plain language.

Start here From nothing installed to a first useful request.

Start here

Getting Started

Install Blacksite, connect a model provider, and make a useful first request. No prior AI-tooling knowledge assumed.

Start here

Providers, Keys & Models

Choose Anthropic, OpenAI, OpenRouter, or Bedrock; understand where your key lives and who receives your data.

Using Blacksite How to drive each surface well.

Using Blacksite

Working with Chat

The agent loop in practice: request profiles, slash commands, attachments, question cards, approvals, compaction, and subagents.

Using Blacksite

Using the Codebase Map

What the map shows, how to navigate it, the queries the agent runs against it, and how notes turn knowledge into graph edges.

Using Blacksite

Plans, Context & Memory

Keep plans, project guidance, memory, and map notes useful after a conversation ends.

Using Blacksite

Tickets & the Board

Capture follow-up work without derailing the current task, then triage it, map it, or turn it into a plan.

Using Blacksite

Data Workbench

An embedded SQLite workbench the agent can use too — reading through the same layer you do, and never executing a write.

Reference Look things up. Every setting, tool, and gate.

Reference

Tool Reference

A technical lookup for the capabilities Blacksite may use on your behalf. Most readers do not need to start here.

Reference

Settings & Commands

Every blacksite.* setting and command, with defaults and the reason you might change one.

Reference

Approvals & Safety

Where the gates sit, what the three permission lists do, what leaves your machine, and the one setting to think hard about.

Reference

Troubleshooting

Symptoms, likely causes, and what to try — from a missing model in the picker to a map that goes blank.

Inside Blacksite Optional technical background for readers who want to inspect the design.

Inside Blacksite

Codebase Map

How the map is indexed, laid out, and rendered — from file discovery through the WebGL scene graph.

Inside Blacksite

LSP Code Intelligence

The design spec for talking to VS Code's language servers instead of guessing at semantics.

Inside Blacksite

Provider-Neutral Agent Environment

Why the agent loop is written against a normalized event stream rather than any one provider's API.

Nothing matches that. Try a broader term, or open an issue if something you expected to find is missing.