Skip to main content

​
What Are Connectors?

AOS connectors are CLI tools that give your ArgentOS agent structured, permission-controlled access to external services. Every connector follows the aos-* naming convention and implements a standard contract: JSON output, permission tiers, self-describing capabilities, and built-in health checks. Unlike MCP servers or plugin extensions, connectors require no long-running processes. They are invoked as shell commands, return JSON, and exit. Any agent that can run shell commands can use them. 
# List GitHub issues
aos-github --json --mode readonly issue.list

# Send a Twilio SMS
aos-twilio --json --mode write messages.send --to "+1555..." --body "Hello"

# Check QuickBooks health
aos-quickbooks --json health

​
Architecture

Key design decisions:
  • No daemons — connectors are stateless CLI calls
  • JSON-first — every command returns a structured envelope
  • Permission-enforced — readonly, write, full, admin tiers
  • Self-describing — capabilities --json returns the full command manifest
  • Health-checked — health --json reports readiness and setup status

​
Available Connectors

ArgentOS ships with 61 connectors covering CRM, project management, communication, accounting, developer tools, and more:

CRM & Sales

aos-hubspot, aos-salesforce, aos-pipedrive, aos-close, aos-clientsync

Project Management

aos-linear, aos-jira, aos-asana, aos-clickup, aos-monday, aos-trello, aos-notion, aos-dart

Communication

aos-slack, aos-teams, aos-twilio, aos-discord-workflow, aos-slack-workflow

Accounting & Finance

aos-quickbooks, aos-xero, aos-stripe, aos-square, aos-paypunch

Marketing

aos-mailchimp, aos-klaviyo, aos-buffer, aos-hootsuite

Developer Tools

aos-github, aos-coderabbit, aos-blacksmith, aos-neon, aos-supabase, aos-pinecone

E-Commerce

aos-shopify, aos-woocommerce, aos-wordpress

Productivity

aos-google, aos-google-drive, aos-google-places, aos-m365, aos-airtable, aos-box, aos-dropbox, aos-calendly

AI & Media

aos-openai, aos-anthropic, aos-claude-code, aos-elevenlabs, aos-canva, aos-nanob, aos-perplexity, aos-firecrawl

Automation

aos-zapier, aos-make, aos-n8n

MSP & IT

aos-connectwise, aos-holace, aos-lion-report, aos-callscrub

Email

aos-sendgrid, aos-resend, aos-pagerduty

​
Where Connectors Live

Connectors are discovered from multiple locations (checked in order):
LocationPurpose
tools/aos/ in the ArgentOS repoVendored connectors shipped with ArgentOS
~/.argentos/connectors/User-installed connectors
ARGENT_CONNECTOR_REPOS env varCustom connector directories
System PATHAny aos-* binary on PATH

​
Three Types of Packages in ArgentOS

TypeFormatWhat It DoesExamples
ConnectorsPython CLI (aos-*)Structured access to external servicesaos-github, aos-slack, aos-stripe
SkillsMarkdown (SKILL.md)Agent capabilities and knowledgeweather, github, spotify-player
ExtensionsTypeScript pluginGateway hooks, channels, toolstelegram, discord, aos-lcm

​
Deep Dives

How Connectors Work

CLI contract, JSON envelopes, permission model, health checks

Build a Connector

Step-by-step guide to creating a new AOS connector from scratch

Publish to Marketplace

Package, sign, submit, and list your connector

Connector Reference

Full list of all 61 connectors with categories and commands