Skip to content

Conversation

@matifali
Copy link
Member

@matifali matifali commented Nov 1, 2025

Revised the AI Bridge documentation to clarify provider configuration steps, including new sections for OpenAI, Anthropic, and Amazon Bedrock. Added details on pre-configuring templates and using AI Bridge with Coder Tasks. Introduced a new image illustrating the AI Bridge implementation details. Updated compatibility notes for various AI clients.

Addresses coder/aibridge#4

Preview: https://coder.com/docs/@aibridge-client-instructions/ai-coder/ai-bridge

…r additional providers

Revised the AI Bridge documentation to clarify provider configuration steps, including new sections for OpenAI, Anthropic, and Amazon Bedrock. Added details on pre-configuring templates and using AI Bridge with Coder Tasks. Introduced a new image illustrating the AI Bridge implementation details. Updated compatibility notes for various AI clients.

Addresses coder/aibridge#4
@matifali matifali changed the title docs(ai-bridge): update configuration instructions and add support for additional providers docs: add client configuration section and support matrix Nov 1, 2025
@matifali matifali changed the title docs: add client configuration section and support matrix docs: add client configuration section and support matrix for AI Bridge Nov 1, 2025
@matifali matifali force-pushed the aibridge-client-instructions branch 2 times, most recently from c9c35ac to 52f51bc Compare November 1, 2025 18:23
Revised client support table for enhanced clarity.
@matifali matifali force-pushed the aibridge-client-instructions branch from 52f51bc to 458890f Compare November 1, 2025 18:34
@matifali matifali added the cherry-pick/v2.28 Needs to be cherry-picked to the 2.28 release branch label Nov 3, 2025
Copy link
Collaborator

@david-fraley david-fraley left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If you've got time to address this high level feedback before release, let's do it. If not, let's make it happen quickly after. It's not a hard requirement for merge, but I don't want to let it hang out too long...

This page is getting MaSSiVe 😂. Can we break it up into a top-level "AI Bridge" w/ the summary, then sub pages covering (this is just a first stab, feel free to riff on the sub page breakdown)

  • Setup
  • Client Config
  • MCP
  • Monitoring
  • Reference (super technical documentation)

Splits the AI Bridge documentation into multiple pages to improve readability and navigation.
@matifali
Copy link
Member Author

matifali commented Nov 3, 2025

I have addressed the feedback and pushed the changes.

@matifali matifali marked this pull request as draft November 3, 2025 17:31
@matifali matifali force-pushed the aibridge-client-instructions branch from 3e24b0d to 33c54ea Compare November 3, 2025 17:51
@matifali matifali marked this pull request as ready for review November 3, 2025 17:54
@matifali matifali requested a review from david-fraley November 3, 2025 17:54
Use "AI Bridge" consistently across the documentation, replacing instances of "Bridge." Adjust headings and content throughout to ensure clarity and alignment with the AI Bridge branding.
@matifali matifali force-pushed the aibridge-client-instructions branch from 68daf40 to 82aa5dc Compare November 3, 2025 18:30
@matifali matifali marked this pull request as draft November 3, 2025 18:30
- Capitalize section headings for consistency.
- Use the singular form for "provider" for clarity.
- Ensure document syntax matches Coder documentation style guidelines.
@david-fraley david-fraley marked this pull request as ready for review November 4, 2025 04:04
Copy link
Contributor

@dannykopping dannykopping left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really liking the reorganisation.

Pausing here for the moment; ran out of time to review.
I've only reviewed up to the start of Client Config page, in the order of how it appears on the website.

Thanks for providing a docs preview link, that was very helpful.

Instead of distributing provider-specific API keys (OpenAI/Anthropic keys) to users, they authenticate to AI Bridge using their **Coder session token** or **API key**:

- **OpenAI clients**: Users set `OPENAI_API_KEY` to their Coder session token or API key
- **Anthropic clients**: Users set `ANTHROPIC_API_KEY` to their Coder session token or API key
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have you tested this? I've only tested ANTHROPIC_AUTH_TOKEN in Claude Code.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm gonna merge as-is for this sentence, but let @matifali fast follow if we need to change

@david-fraley david-fraley removed the cherry-pick/v2.28 Needs to be cherry-picked to the 2.28 release branch label Nov 6, 2025

## Tested Clients

The table below shows tested AI clients and their compatibility with AI Bridge. Click each client name for vendor-specific configuration instructions. Report issues or share compatibility updates in the [aibridge](https://github.com/coder/aibridge) issue tracker.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Click each client name for vendor-specific configuration instructions

Not all clients have links set?

Also, weren't we going to provide setup details for each client?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll leave this one for @matifali to quick follow

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Having details for each client can be overly extensive. Also most of them are just setting the correct URL and token which we already explain.

Also couldn't find a very good organization for clients.

For URLs I linked to the setup docs for each I could find. Will add any missing ones.

@david-fraley david-fraley enabled auto-merge (squash) November 10, 2025 22:07
@david-fraley david-fraley merged commit c21b3e4 into main Nov 10, 2025
24 of 25 checks passed
@david-fraley david-fraley deleted the aibridge-client-instructions branch November 10, 2025 22:24
@github-actions github-actions bot locked and limited conversation to collaborators Nov 10, 2025
@matifali
Copy link
Member Author

@dannykopping @david-fraley follow up here: #20714

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants