Custom AI tool integrations
Set up custom integrations to track adoption and usage of any AI coding tool in Swarmia.
Last updated
Was this helpful?
Set up custom integrations to track adoption and usage of any AI coding tool in Swarmia.
Read more about Swarmia's other AI coding tool integrations and understanding the impact of AI tools.
Swarmia has built-in integrations for GitHub Copilot, Cursor, and Claude Code. For any other AI coding tool, you can create a custom integration, so it shows up alongside the built-in ones in AI adoption and AI tool detection and filters.
You define a custom AI tool in Swarmia, then push daily per-user usage data to it from your own scripts or systems. For each user and day, report both whether they had access to the tool (is_enabled) and whether they actively used it (is_active) — that's what separates active seats from idle ones in AI adoption.
You can also send optional details like message counts, subscription tiers, spend, and breakdowns by model, client, or programming language. Swarmia stores this detail, but it isn't visible in the app yet.
Swarmia matches each record to an author by email. It stores the usage as daily metrics, and sending the same user, tool, and date again overwrites the previous values, so you can safely re-send a day's data.
Because the data is daily and not tied to individual commits, pull requests are attributed to a custom AI tool using time-based (low-confidence) attribution: a pull request counts as assisted when its commit author used the tool within the previous 24 hours.
You need the organization admin role to manage integrations.
Go to Settings → AI tools and find the Other AI tools section.
Click Add new.
Enter a Name (shown in reports) and an API identifier (aiService in the additional AI integrations API). The identifier can't be changed after creation.
Click Save.
The tool's row shows when Swarmia last received data for it. You don't need to create it in advance, since posting data for a new identifier creates the tool automatically.
To rename a tool or delete it, click the edit icon on its row. Deleting a tool also removes all of its usage data.
Usage data is submitted to the additional AI integrations API, which authenticates with an API token. Generate one with the AI Usage scope in Settings → API tokens. The API reference documents the endpoint, the full request schema, and every field you can report.
The GitHub Copilot, Cursor, and Claude Code integrations fetch data for you once you connect them. With a custom AI tool, you're responsible for collecting the usage data from your tool and pushing it to Swarmia through the API.
In AI adoption, alongside the built-in tools, once the tool has received user data. The tool also appears in AI tool detection and filters, where pull requests are attributed to it through time-based (low-confidence) attribution.
Yes, you can send data for any dates via the additional AI integrations API.
Support for custom coding agents and review agents is coming soon. You'll be able to set them up by configuring their authors, without sending data through the API.
Last updated
Was this helpful?
Was this helpful?