> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.astropods.com/cli/knowledge/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.astropods.com/_mcp/server.

# ast knowledge

Connect a database to the active account as a [knowledge store](/knowledge-stores), then inspect or remove it.

```bash
ast knowledge <subcommand>
```

## knowledge connect

```bash
ast knowledge connect --provider <provider> --name <name> --host <host> --port <port> \
  [--database <db>] [--username <user>] [--password <pass>] [--api-key <key>] \
  [--private-link] [--skip-health-check]
```

`--provider` takes `postgres`, `qdrant`, `redis`, `neo4j`, or `pinecone`. Prompts for the password when neither `--password` nor `--api-key` is set. Credentials are stored encrypted.

Astropods checks that it can reach the database. If the check fails, the store is saved with an error status, and you reconnect it once the database is reachable. Pass `--skip-health-check` to skip the check.

With `--private-link`, `--host` takes the VPC endpoint service name (`com.amazonaws.vpce.<region>.vpce-svc-...`). The command then waits until the PrivateLink endpoint is ready. Approve the pending connection request on your endpoint service while it waits. See [Connect a private database](/knowledge-stores#connect-a-private-database).

## knowledge list

```bash
ast knowledge list [--json]
```

## knowledge status

```bash
ast knowledge status <name> [--json]
```

## knowledge credentials

```bash
ast knowledge credentials <name> [--json]
```

Prints the store's credentials as `KEY=value` lines.

## knowledge delete

```bash
ast knowledge delete <name>
```

Asks for confirmation before it deletes the store.

## Next steps

* [Knowledge stores](/knowledge-stores): how stores work and how to connect a private database
* [Using knowledge stores](/knowledge-store-agent): bind a store to an agent at deploy time

> Connect and manage the account's knowledge stores