# Glove Foundry > Glove Foundry (glove-foundry) is the application framework that runs Glove agents as a service. Agents are TypeScript files (agents//agent.ts); Foundry adds persisted agent instances and conversations, a run queue, a typed client, a REST API, OpenAI-compatible /v1/chat/completions and /v1/responses, schedules, sleep and spawn, inbound/outbound integrations with playbooks, tool approvals, run steering, working environments, and a built-in inspector and WebChat. Key facts: - Install: npx glove-foundry init my-agents; run: pnpm dev (http://127.0.0.1:4141). Node 22+; 22.13+ for SQLite memory. - composeAgent(...) only makes shared tools, apps and MCP servers available; an instance must install() them. Always-on tools go in defineAgent's tools field. - Instances are data (FoundryDataAdapter); every run reloads the instance and conversation and re-resolves the definition against the new message. - Each run executes in a fresh child process: a plain MemoryStore and other in-memory state reset on every message. Persist four things separately: runtime data, transcripts (store), memory, and working-environment files. - Install capabilities with install() at creation, client.install, or PUT /api/installations; the inspector only displays installations. - Foundry never acquires, stores or refreshes credentials; accounts carry an opaque accessRef resolved by your adapter. - A non-loopback bind requires a requestAuthorization adapter. - Product page: https://glove.dterminal.net/foundry - Complete condensed reference: https://glove.dterminal.net/foundry/llms-full.txt - Glove (core and packages) index: https://glove.dterminal.net/llms.txt - Source: https://github.com/porkytheblack/glove/tree/main/packages/glove-foundry - Canonical example: https://github.com/porkytheblack/glove/tree/main/examples/foundry-agent - Agent skill: https://github.com/porkytheblack/glove/blob/main/.claude/skills/glove-foundry/SKILL.md ## Start - [Overview](https://glove.dterminal.net/foundry/docs): What Foundry gives you out of the box, when to use it instead of plain Glove, and the definition → instance → run model. - [Install & CLI](https://glove.dterminal.net/foundry/docs/getting-started): The setup wizard, both starter templates, every CLI command and flag, and your first run in the inspector. - [Tutorial: first agent system](https://glove.dterminal.net/foundry/docs/tutorial): Build a support agent step by step: a tool, an installed app, instances, conversations, a schedule, an approval, and an OpenAI SDK client. - [Project structure](https://glove.dterminal.net/foundry/docs/project-structure): Every file convention, how filenames become ids, foundry.application.ts vs foundry.config.ts, generated route types and the ESLint preset. ## Build agents - [Definitions & instances](https://glove.dterminal.net/foundry/docs/definitions-and-instances): What belongs in code, what belongs in data, how instances are created, updated and reconstructed, and where string ids are correct. - [defineAgent & assembly](https://glove.dterminal.net/foundry/docs/composition): Every defineAgent field, the value-or-resolver rule, the assembly context, and configure/build/run lifecycle hooks. - [Tools, MCP & memory](https://glove.dterminal.net/foundry/docs/capabilities): Always-on tools vs installable shared tools, MCP servers over HTTP or stdio, memory profiles, layers, subscribers, and typed calls. - [Goals, facts & forms](https://glove.dterminal.net/foundry/docs/guidance): Guided conversations, durable evidence and answers, native preparation, and live context providers. ## Connect & automate - [Apps & transmissions](https://glove.dterminal.net/foundry/docs/applications): Installable capability bundles, inbound and outbound transports, accounts, routes, connections, and the credential boundary. - [Playbooks, schedules & sleep](https://glove.dterminal.net/foundry/docs/automation): Event-driven playbooks, subscriptions that provision agents, cron and interval schedules, sleep, spawn and the built-in agent tools. ## Give agents a world - [Conversations & shared work](https://glove.dterminal.net/foundry/docs/conversations): Many conversations per instance, transcripts, workspace entries, the shared inbox, tasks, and scoped environment values. - [Working environments](https://glove.dterminal.net/foundry/docs/working-environments): Mount a VFS, a REPL, programmatic tool calling, skills, and document or media adapters for artifact-producing agents. - [Browser & sandbox agent](https://glove.dterminal.net/foundry/docs/browser-and-sandbox): A runnable personal agent with mounted browser scripts, persistent code sandboxes and managed servers on one Station. - [Multi-agent systems](https://glove.dterminal.net/foundry/docs/multi-agent): Subagents with least-privilege tools, typed calls, spawn, mesh, voice hosts, and coordination through shared work. ## Operate - [Client & HTTP API](https://glove.dterminal.net/foundry/docs/runtime): The typed client, every native /api endpoint, the /v1/runs automation API, live event streams and health checks. - [OpenAI-compatible API](https://glove.dterminal.net/foundry/docs/openai-compatible): Point any OpenAI SDK at Foundry: /v1/chat/completions and /v1/responses backed by durable instances and conversations. - [Approvals & steering](https://glove.dterminal.net/foundry/docs/approvals): Human-in-the-loop: permission-gated tools become expiring approval records; redirect active work with interrupt-and-restart steering. - [Inspector & WebChat](https://glove.dterminal.net/foundry/docs/observability): The built-in inspector, WebChat, run traces, keyboard shortcuts, the event envelope, and custom subscribers. - [Persistence](https://glove.dterminal.net/foundry/docs/persistence): The four things to persist separately — runtime data, transcripts, memory and the VFS — with file, SQLite and custom adapters. - [Next.js integration](https://glove.dterminal.net/foundry/docs/nextjs): Add Foundry to an existing Next.js app: the generated layout, the typed client, route handlers and FOUNDRY_URL. - [Deploy & security](https://glove.dterminal.net/foundry/docs/deploy): Production checklist, request authorization, health checks, the managed execution daemon and scaling by role. ## Reference - [API reference](https://glove.dterminal.net/foundry/docs/reference): Every export of glove-foundry and its subpaths, the built-in agent tools, HTTP endpoints, CLI flags and config keys in one place. - [FAQ & troubleshooting](https://glove.dterminal.net/foundry/docs/faq): Why a tool is missing, why state reset, why the server refuses to bind, and other questions people ask in their first week.