Agent sources

An agent source is a GitHub repository of agents. Agent City adds the official Agent City source for you, with specialists like Scoop (AI news), Skye (flights), Ticker (shares), Dispatch (news), Cloudflare DNS and Gmail.

Install an agent

1. Open Agents → Browse.
2. Find an agent and press Review & install.
3. Read its files, starting with tools.py, which is the code that will run. Give it another name if you like.
4. Press Install. It joins your team straight away, with no restart.

If it needs a key or sign-in, its card says Needs and Connections shows what to add.

Only install agents you trust

An installed agent’s code runs inside Agent City, with Agent City’s access to your files. Each agent’s tools only see the keys and sign-ins it declares, but that isn’t a wall against code written to get around it. Read the code before you install.

Add a source

1. Open Settings → Tools → Agent sources.
2. Paste a repository’s link: https://github.com/owner/repo, or …/tree/branch for a branch.

Its agents appear on Browse. Adding a source doesn’t install anything. Reading a repository never runs its code.

You can remove any source, including the default one, and it stays removed. Removing a source leaves its installed agents as they are, but they can no longer be updated.

Updates

Refresh reads a source again. An agent whose files changed says Update available, with the new version if it has one (v1.0.0 → v1.1.0). Review shows exactly what changed, and Update installs it, keeping any name you gave it. Nothing updates on its own.

GitHub limits

GitHub allows 60 requests an hour without a key, and a refresh uses three. Add a GITHUB_TOKEN on Connections to raise that and to add private repositories.

Publish your own

Any GitHub repository of agent folders can be a source. See Host your own agent source for the layout, hive.json, limits and updates, and Agent files for what goes in each agent.