Aident-AI/aident-skill / releases/0.4.12
aident-skill
VerifiedUse Aident Loadout to connect your AI agents to 1,000+ real-world apps and tools like Gmail, Slack, Linear, Notion, Firecrawl, and Fal, unlock 27,000+ executable actions, and track full audit history so your agents can get real work done reliably.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.3 KB |
| references/api.md | markdown | 5.3 KB |
| references/loadout.md | markdown | 16.5 KB |
| references/mcp.md | markdown | 4.0 KB |
| references/troubleshooting.md | markdown | 2.3 KB |
references/api.md
View on GitHub# OpenAPI Reference
Use the OpenAPI surface when an agent host needs raw HTTPS instead of the CLI or MCP. The CLI and MCP servers are wrappers around the same package operations.
## Base URLs
```text
https://loadout.aident.ai/api/openapi/loadout.json
https://loadout.aident.ai/api/openapi/loadout/operations
https://loadout.aident.ai/api/openapi/loadout/{operationId}
```
Use `AIDENT_BASE_URL` to target another Aident deployment:
```bash
export AIDENT_BASE_URL=https://your-server.example.com
```
## Getting A Token
Tokens are persisted to `~/.aident/credentials.json` after `aident login`. For direct HTTPS scripts, export the access token as `AIDENT_TOKEN`.
OAuth endpoints remain under the MCP OAuth namespace because MCP and OpenAPI use the same Aident OAuth server:
```text
POST /api/mcp/oauth/register
GET /api/mcp/oauth/authorize
POST /api/mcp/oauth/token
POST /api/mcp/oauth/revoke
```
## Discover Operations
Fetch the Loadout OpenAPI document:
```bash
curl -H "Authorization: Bearer $AIDENT_TOKEN" \
"${AIDENT_BASE_URL:-https://loadout.aident.ai}/api/openapi/loadout.json"
```
Fetch compact operation metadata:
```bash
curl -H "Authorization: Bearer $AIDENT_TOKEN" \
"${AIDENT_BASE_URL:-https://loadout.aident.ai}/api/openapi/loadout/operations"
```
Operation IDs are stable and package-prefixed. Common Loadout operations:
| Operation ID | CLI equivalent |
| ------------------------------ | -------------------------------------------- |
| `loadout_capabilities_search` | `aident capabilities search` |
| `loadout_capabilities_get` | `aident capabilities get` |
| `loadout_capabilities_execute` | `aident capabilities execute` |
| `loadout_vault` | `aident vault status / connect / disconnect` |
| `loadout_audit` | `aident audit recent / summary` |
Use `loadout_capabilities_search` with `types: ["integration"]` to discover integrations; Loadout does not expose a
separate public integrations-list operation.
## Execute Operations
POST the command arguments directly to the operation URL.
```bash
curl -X POST "${AIDENT_BASE_URL:-https://loadout.aident.ai}/api/openapi/loadout/loadout_capabilities_search" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AIDENT_TOKEN" \
-d '{ "query": "send email", "limit": 5 }'
```
Execute a capability:
```bash
curl -X POST "${AIDENT_BASE_URL:-https://loadout.aident.ai}/api/openapi/loadout/loadout_capabilities_execute" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AIDENT_TOKEN" \
-d '{
"name": "composio:gmail_tools:gmail_send_email",
"input": { "to": "team@example.com", "subject": "Notes", "body": "..." }
}'
```
Check Vault connection status:
```bash
curl -X POST "${AIDENT_BASE_URL:-https://loadout.aident.ai}/api/openapi/loadout/loadout_vault" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AIDENT_TOKEN" \
-d '{ "action": "status" }'
```
Audit recent Loadout action calls:
```bash
curl -X POST "${AIDENT_BASE_URL:-https://loadout.aident.ai}/api/openapi/loadout/loadout_audit" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AIDENT_TOKEN" \
-d '{ "action": "summary", "limit": 50 }'
```
## Multi-Account Fields
Multi-account connections are a Pro feature. Pay-as-you-go users are limited to one connected account per integration and use that integration's default account. Only offer account selection when Vault or capability output confirms that multi-account fields are available.
For eligible Pro users:
- `loadout_capabilities_execute` accepts an optional top-level `accountAlias` field beside `name` and `input` to pin an Action to one connected account. When a side-effecting Action's integration has more than one active account, omitting it returns `account-selection-required` with the default-first account list.
- Successful Action execution results include `usedUserAccount`, the summary of the account that performed the Action.
- `loadout_vault` connect accepts `addAccount` or `accountAlias` with `replaceAccountConfirmed`; disconnect requires `accountAlias` when multiple accounts exist.
## Error Handling
| HTTP Status | Meaning |
| ----------- | -------------------------------------------------------------------- |
| 200 | Success. Check the returned `success` field. |
| 400 | Invalid request body or unsupported operation. |
| 401 | Invalid or expired token. Reauthenticate or refresh. |
| 403 | Authenticated account lacks the required package or operation scope. |
| 426 | CLI/client version is too old for this server. |
| 500 | Operation execution error. Check the returned `error` field. |
## Advanced Overrides
| Variable | Purpose |
| ----------------- | ---------------------------------------------------------- |
| `AIDENT_TOKEN` | Skip credential file and use this Bearer token directly. |
| `AIDENT_BASE_URL` | Override the default server (`https://loadout.aident.ai`). |
## Rate Limits
Standard rate limits apply. If rate limited, wait and retry with exponential backoff.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |