nestr-agents
Nestr Agents & Connectors
An agent is a bot user in the workspace. It does work when it fills a role or is assigned to a task. A connector is a catalog entry for an outside tool (an MCP server, an API or a CLI). A connection binds a connector to an owner, usually a role's domain, and a person connects an account to it through a link.
First run nestr profiles add (OAuth or API key) — a profile pairs a workspace
with an identity. Global flags on every command: -p/--profile, -o text|json,
--read-only (block writes), and --yes (skip write confirmations; required for
agents). Full setup, env overrides, and the command map:
shared/reference.md.
Who can run what. Commands marked admin need a workspace admin; they also work with a workspace API key. Commands marked user login need an OAuth or user login, because the server records who asked: a workspace API key gets a 403 there.