Glossary

Agent definition — a reusable coding-agent configuration: which agent, its prompt and files, its tools, which secrets it may use. Scoped to an organization, workspace or project. → more

Agent profile — a stored preset that pre-fills launch choices. Configures nothing on its own.

Base image — a container image a project can start from instead of a Git repository.

Builder — a short-lived container that turns a project into an image. Appears when something needs building; you do not create one. → more

Coding agent — Claude Code or Codex, running inside your container against your code, on your model account. → more

Coding-agent credential — the model-account credential the agent runs on. Personal or shared, and frozen into a container at launch. → more

Company — what the API calls an Organization. Same object, two vocabularies.

Controller — the PlatformSmith component running on your infrastructure that actually starts containers. Registers itself and self-reports its version. → more

Conversation — the sidebar noun for a platform-created multi-party thread. Not Forgemate's history. → more

Environment — a registered place containers can be created: a Host with Docker, or a Kubernetes cluster you bring. Not a deployment stage. → more

Environment role — what an environment is for: sandbox, build or deployment. Fixed when the environment is created. A build environment must be a Host with Docker.

Forgemate — the in-app assistant available on every screen. Its history is a thread. → more

Git connection — an organization-level authorization letting PlatformSmith and your agents reach your repositories. Not the same as signing in with GitHub. → more

Install code (psic_…) — a single-use, 15-minute credential used by the Kubernetes install command. → more

Integration — a connection to an outside service. Company integrations are configured once for everyone; personal integrations follow your account. → more

Organization — your tenant. Everything lives inside exactly one. company in the API.

Personal access token (PAT) — a token you mint to call the API as yourself. → more

Playbook — a saved, repeatable piece of agent work, with a record of each run. → more

Playbook run — one execution of a playbook. → more

Project — what code: a repository or a base image, plus its settings. → more

Registry — where project images are pushed and pulled from. → more

Runtime — one launch: this project, in that environment. → more

Runtime instance — the live container a runtime produced. Relaunching gives a runtime a new instance. → more

Sandbox — an interactive container with a coding agent in it. The one you create. → more

Secret — an encrypted value an agent may be given. Scoped to organization, workspace or project, optionally pinned to an environment. → more

Session — one live conversation between you (or an automation) and a coding agent inside a container. → more

Thread — Forgemate's history. Not the sidebar's Conversations. → more

Workspace — a container for related work: projects, environments, members and settings. → more

Workspace token (pst_…) — the credential a controller uses to attach to an environment. Shown once. → more