# Docs for AI

Use this page when you want to give Bkper documentation to an AI assistant without copying entire web pages. It works for hosted chat tools and coding agents.

Every page on bkper.com is available as clean Markdown. Navigation chrome — sidebar, header, footer — is stripped, reducing token usage for AI tools.

## Formats

Three ways to get docs into your AI. Pick the one that matches your workflow.

### `llms.txt` — explore

A structured index of every article with descriptions. Start here when you want your AI to browse and pick what to read.

- [`/llms.txt`](https://bkper.com/llms.txt) — all site content
- [`/docs/llms.txt`](https://bkper.com/docs/llms.txt) — all docs
- [`/docs/ai/llms.txt`](https://bkper.com/docs/ai/llms.txt) — AI docs
- [`/docs/guides/llms.txt`](https://bkper.com/docs/guides/llms.txt) — user-facing guides
- [`/docs/build/llms.txt`](https://bkper.com/docs/build/llms.txt) — developer docs
- [`/docs/api/llms.txt`](https://bkper.com/docs/api/llms.txt) — API libraries at a glance

### `llms-full.txt` — deep dive

The complete text of every article in a scope. No links to chase, no extra requests. Use this when you need comprehensive context on a specific topic.

- [`/llms-full.txt`](https://bkper.com/llms-full.txt) — all site content
- [`/docs/llms-full.txt`](https://bkper.com/docs/llms-full.txt) — all docs
- [`/docs/ai/llms-full.txt`](https://bkper.com/docs/ai/llms-full.txt) — all AI docs
- [`/docs/build/apps/llms-full.txt`](https://bkper.com/docs/build/apps/llms-full.txt) — all app docs
- [`/docs/build/scripts/llms-full.txt`](https://bkper.com/docs/build/scripts/llms-full.txt) — all script docs

### `.md` — single page

Any individual page as Markdown. Use this when you already know the exact page you need.

Append `.md` to the URL:

```text
https://bkper.com/about.md
https://bkper.com/docs/core-concepts.md
https://bkper.com/docs/ai/cli-vs-mcp.md
```

```sh
curl https://bkper.com/docs/core-concepts.md
```

Or request it via the `Accept` header — no URL modification needed:

```sh
curl https://bkper.com/docs/core-concepts \
  -H "Accept: text/markdown"
```

The response includes an `x-markdown-tokens` header with the estimated token count, which agents can use to plan context window usage:

```text
HTTP/2 200
content-type: text/markdown; charset=utf-8
vary: Accept
x-markdown-tokens: 1850
```

Every documentation page also has a **View as Markdown** link in the right sidebar. It opens the current page's `.md` version in the same tab.

## API references

API reference endpoints compile the library overview and full spec into a single compact document optimized for agent workflows:

- [`/docs/api/rest.md`](https://bkper.com/docs/api/rest.md) — endpoints, parameters, and data models
- [`/docs/api/bkper-js.md`](https://bkper.com/docs/api/bkper-js.md) — bkper-js README + TypeScript definitions
- [`/docs/api/bkper-gs.md`](https://bkper.com/docs/api/bkper-gs.md) — bkper-gs README + TypeScript definitions
- [`/docs/api/bkper-api-types.md`](https://bkper.com/docs/api/bkper-api-types.md) — shared TypeScript type definitions
- [`/docs/api/bkper-web-auth.md`](https://bkper.com/docs/api/bkper-web-auth.md) — OAuth browser SDK

Compiled Markdown vs raw source:

| Library         | Raw tokens | `.md` tokens | Reduction |
| --------------- | ---------: | -----------: | --------: |
| REST API        |       ~38K |          ~9K |        4× |
| bkper-js        |       ~32K |         ~18K |      1.8× |
| bkper-gs        |       ~22K |         ~12K |      1.9× |
| bkper-api-types |       ~12K |          ~5K |      2.4× |
| bkper-web-auth  |        ~2K |          ~2K |       ~1× |

## Agent skills and plugins

For coding agents that support plugins or Agent Skills, use the Bkper CLI skill instead of manually pasting docs.

- [Coding Agents](https://bkper.com/docs/ai/coding-agents.md#install-the-bkper-cli-plugin-or-skill) — install the Codex plugin, Claude Code plugin, or portable Agent Skill.
- [Bkper CLI Agent](https://bkper.com/docs/ai/bkper-cli-agent.md) — use Bkper's first-party terminal agent with context built in.
- [Source on GitHub](https://github.com/bkper/bkper-cli/tree/main/skill) — inspect the generated skill package.