Connect a data source to the core

This is the Connect pillar in one guide: bring a real data source into the core so any agent can act on it.

A connector mounts an external source read-only into your project's /workspace/connectors/<mount_prefix>/. You register it once with connector.add, pull the content with connector.refresh, and from then on the agent just reads files with sh. The connection lives in the core — not scattered across scripts.

Connect a GitHub repo

connector.add registers the instance (it does not fetch yet); connector.refresh materialises it.

connector.add {
  "account_slug": "acme",
  "project_slug": "demo",
  "connector_name": "github",
  "mount_prefix": "app-repo",
  "config": { "owner": "acme", "repo": "app", "ref": "main" },
  "credentials_ref": "acme-app-gh"   // resolves to a stored PAT
}

connector.refresh {
  "account_slug": "acme",
  "project_slug": "demo",
  "mount_prefix": "app-repo"
}

The agent can now read the tree immediately:

sh "ls /workspace/connectors/app-repo/"
sh "cat /workspace/connectors/app-repo/README.md"

Connect a Postgres database

Same shape — connector_name: "postgres", with the DSN behind credentials_ref. The connector dumps schema + tables as CSV into the workspace, so the agent reads them without a live DB connection:

connector.add {
  "account_slug": "acme",
  "project_slug": "demo",
  "connector_name": "postgres",
  "mount_prefix": "prod-db",
  "config": { "schemas": ["public"], "max_rows": 100000 },
  "credentials_ref": "acme-prod-dsn"
}

sh "ls /workspace/connectors/prod-db/"

What you get

• One place for the connection. Register it once; every agent on the project reads the same materialised view.
• Read-only by default. The source is never mutated — connectors pull in.
• Governed. Access is scoped to the project and the connection is audited like everything else the core touches. Check what's mounted anytime:

connector.list { "account_slug": "acme", "project_slug": "demo" }

Where this fits

This is the Connect everything pillar of connect0 — the core that connects everything your company runs on. A connector is how a real data source becomes something your agents can act on, from one governed hub. Start building → · All guides →