Store Indexes in S3

Experimental API - Context Connectors is experimental and subject to breaking changes.

S3 storage enables two key use cases:

Team Sharing: Multiple team members can search the same index
Application Data: Build apps that manage per-user indexes in S3

Prerequisites

Node.js 18+
Augment API credentials
AWS credentials with S3 read/write access
An S3 bucket

Steps

1. Install

npm install @augmentcode/context-connectors @aws-sdk/client-s3

2. Set credentials

export AUGMENT_SESSION_AUTH='<session-json>'  # from auggie token print
export AWS_ACCESS_KEY_ID='your-key'
export AWS_SECRET_ACCESS_KEY='your-secret'

3. Index to S3

export CC_S3_BUCKET='my-team-bucket'
npx ctxc index github --owner myorg --repo myrepo -i my-project \
  --store s3

You should see:

Fetching file tree from myorg/myrepo...
Indexing complete: 142 files indexed, 0 skipped
Stored to s3://my-team-bucket/context-connectors/my-project/

4. Search from S3

Anyone with AWS credentials can now search:

npx ctxc search "How does authentication work?" \
  -i s3://my-team-bucket/context-connectors/my-project

Indexes are stored under a context-connectors/ prefix in your bucket. Include this prefix when searching.

Done!

Your index is stored in S3 at s3://my-team-bucket/context-connectors/my-project/. Share the S3 URL with your team.

Also Works With

Instead of…	Try…
AWS S3	MinIO: set `CC_S3_ENDPOINT` and `CC_S3_FORCE_PATH_STYLE=true`
AWS S3	DigitalOcean Spaces, Backblaze B2, Cloudflare R2 (use `CC_S3_ENDPOINT`)
Manual indexing	Auto-index on push with GitHub webhooks

Remote MCP Server Custom Client

⌘I

Getting Started

Cosmos

Auggie CLI

Other clients

Admin

Models & Pricing

Troubleshooting

Store Indexes in S3

Prerequisites

Steps

1. Install

2. Set credentials

3. Index to S3

4. Search from S3

Done!

Also Works With

​Prerequisites

​Steps

​1. Install

​2. Set credentials

​3. Index to S3

​4. Search from S3

​Done!

​Also Works With

Prerequisites

Steps

1. Install

2. Set credentials

3. Index to S3

4. Search from S3

Done!

Also Works With