> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Build with Claude Code

> Install the build-on-aster plugin so your AI coding assistant can create, run, and maintain Aster agents through the API

<Note>
  **build-on-aster** is an open-source [Claude Code](https://claude.com/claude-code) plugin that teaches your AI coding assistant to build on Aster through this API — using your organization's API key, with no internal access required.
</Note>

## What it does

With the plugin installed, you can ask Claude Code (or any `SKILL.md`-aware assistant) to:

* **Build agents** — wire up tools, models, knowledge bases, and skills in the right order
* **Stand up knowledge bases** — run the full upload → process → search pipeline
* **Run agents** — invoke an agent and read back its answer (the `POST /chat` → poll loop)
* **Maintain at scale** — update prompts and tools, and manage agents across many organizations
* **Package skills** and **manage your org** (invitations, tags)

It carries the exact request/response shapes, the gotchas that bite first-time integrators, and behavioral rules (read-before-write, verify-after-mutating) — all validated against this live API.

## Install

<Steps>
  <Step title="Add the marketplace and install the plugin">
    ```bash theme={null}
    claude plugin marketplace add asterlabs-ai/build-on-aster
    claude plugin install build-on-aster@aster
    ```

    Or run the same from inside Claude Code: `/plugin marketplace add asterlabs-ai/build-on-aster` then `/plugin install build-on-aster@aster`.
  </Step>

  <Step title="Set your API key">
    Get a key from **Control Hub → Settings → API Access** (a 6-month, org-scoped bearer token), then expose it:

    ```bash theme={null}
    export ASTER_API_KEY="<your-key>"
    ```
  </Step>

  <Step title="Build">
    Ask your assistant to build something — e.g. *"create an agent that summarizes uploaded invoices and put it in a knowledge base."* The plugin handles the API calls, polling, and verification.
  </Step>
</Steps>

<Card title="View the source on GitHub" icon="github" href="https://github.com/asterlabs-ai/build-on-aster">
  `asterlabs-ai/build-on-aster` — open source (MIT). Read the `SKILL.md`, file issues, or contribute.
</Card>

## Prefer a plain skill?

Not using the plugin system? Clone the repo and point any `SKILL.md`-aware tool at it:

```bash theme={null}
git clone https://github.com/asterlabs-ai/build-on-aster ~/.claude/skills/build-on-aster
```

The rest of this API Reference documents every endpoint the plugin builds on.