# Night Owls

> A TypeScript framework for adding governed multi-agent chat to an app you already have.
> Agents are DB-driven, tools are gated behind human approval, and the whole surface is embeddable.

## Importable skills

These are SKILL.md files. Import one into an agent to give it what it needs to adopt Night Owls.
They parse with this framework's own skill importer.

- [nightowls-adopt](https://nightowls.dev/skills/nightowls-adopt.md): Use when adding Night Owls agents to an existing TypeScript or Next.js app, or when asked to install @nightowlsdev packages, define a swarm, mount a chat route, or wire the runner.
- [nightowls-ai-studio](https://nightowls.dev/skills/nightowls-ai-studio.md): Use when building an operator or admin screen for Night Owls, mounting AIStudio, SkillStudio or AgentStudio, or editing agent configuration from a database instead of code.
- [nightowls-governance](https://nightowls.dev/skills/nightowls-governance.md): Use when an agent must ask a human before acting, when tool calls need approval, when scoping which users can reach which agents, or when asked how Night Owls differs from calling a model directly.
- [nightowls-knowledge](https://nightowls.dev/skills/nightowls-knowledge.md): Use when giving a Night Owls agent retrieval over your documents, ingesting or deleting knowledge sources, or upgrading @nightowlsdev/knowledge past 0.1.x.
- [nightowls-skill-store](https://nightowls.dev/skills/nightowls-skill-store.md): Use when importing third-party SKILL.md content into a Night Owls swarm, wiring skill providers such as skills.sh or GitHub, checking imported skills for upstream updates, or mounting the skill-store admin routes.
- [nightowls-tools-connections](https://nightowls.dev/skills/nightowls-tools-connections.md): Use when connecting third-party integrations to a Night Owls swarm, registering outbound MCP servers, auditing which agents hold a capability, or building a connections admin screen.

## Docs

- [Getting started](https://nightowls.dev/docs/getting-started): install, define a swarm, run it locally
- [The AI Studio](https://nightowls.dev/docs/ai-studio): one operator console, section registry
- [The skill store](https://nightowls.dev/docs/skill-store): import third-party skills behind a review gate
- [Knowledge and tools](https://nightowls.dev/docs/knowledge-and-tools): retrieval, connections, MCP registry
- [Agent config surface](https://nightowls.dev/docs/agent-config-surface): the default-deny admin routes
- [Audiences](https://nightowls.dev/docs/agent-audiences): scope which callers reach which agents
- [Sub-org scopes](https://nightowls.dev/docs/org-scope): partition knowledge, skills and runs by department inside one org
- [The SEO crew](https://nightowls.dev/docs/agent-seo): a read-only analyst + metered researcher over Google Search Console + GA4
- [Client tools](https://nightowls.dev/docs/client-tools): tools the model calls but the browser runs
- [Attachments](https://nightowls.dev/docs/attachments): host-owned upload + resolution so an agent can read a file
- [Capability bundles](https://nightowls.dev/docs/capability-bundles): package agents, rules and grants as one unit

## Packages

Published under the @nightowlsdev scope on npm. Start with @nightowlsdev/core plus a runner, a
storage adapter and a model adapter.