Glossary

Plain-English meanings of the words Prismor and its dashboard use. Each entry links to the page that covers it in depth. New to Prismor? Start with Getting started.

Agent

An AI coding assistant that can take actions on your computer, such as Claude Code, Codex, Cursor or Copilot. Prismor watches what agents do. Each agent registers itself the first time it runs in a project Prismor protects. See Dashboard: Agents tab.

Allow / warn / block

The three basic outcomes of a check. Allow means the action runs. Warn means it runs, but a finding is recorded so you can see it. Block means it is stopped before it runs, and the agent is told why. A rule only blocks in enforce mode. See Rule actions.

Audit trail

A tamper-evident record of every action an agent took through Prismor, kept in ~/.prismor/audit/. Each record is linked to the one before it and signed, so an edited or deleted record shows up when you run prismor trail verify. See Signed audit trail.

Cloak / secret cloaking

A way to keep real passwords and API keys out of the agent's view. You store a secret once with prismor cloak add <name>, and the agent only sees a placeholder such as @@SECRET:name@@. The real value is filled in when a command runs and scrubbed from the output. See Sweep and Cloak.

Egress

Network traffic leaving your machine, such as an agent fetching a web page or sending data to an API. Prismor's egress policy is a list of hosts agents may or may not contact. See Network isolation.

Enforce mode

The setting where Prismor stops actions that match a blocking rule, before they run. Compare observe mode. See Modes.

Extension

Anything that adds instructions or code to an agent from outside: a skill, a plugin, a hook command or an MCP server. Prismor keeps a list of them and flags new or changed ones until someone reviews them. See Extension ledger.

Finding

A record that a rule matched an action. A finding has a severity (critical, high, medium or low) and does not always mean something was blocked: in observe mode, or for warn-only rules, the action still ran. See Dashboard.

Hook

A small command an agent runs at set moments, which lets Prismor see and judge what the agent is about to do. prismor setup or prismor install-hooks installs them. The main moments, using Claude Code's names:

  • PreToolUse: just before a tool call runs. This is where Prismor can block.
  • PostToolUse: just after a tool call, with its result.
  • UserPromptSubmit: when you send the agent a message.
  • SessionStart: when a new agent session begins.

Other agents use their own names for the same moments. See Governance surfaces.

Inherit (global)

An agent setting on the dashboard's Agents page. inherit (global) means the agent follows the mode set by policy (organization, project or global) instead of its own observe or enforce override. See Dashboard: Agents tab.

MCP server

A separate program that gives an agent extra tools, for example to talk to GitHub or a database. MCP stands for Model Context Protocol. Prismor can sit in front of MCP servers and check each call. See MCP gateway.

Mode

A named security setup that sets many options at once. Prismor ships three: dev-safe, trusted-workspace and regulated-airgap. "Mode" is also used for the simpler choice between observe and enforce. See Modes.

Observe mode

The setting where Prismor checks and records every action and reports anything risky, but blocks nothing. A safe way to start. Compare enforce mode. See Modes.

Pause

Temporarily stops Prismor from blocking, while it keeps checking and recording. prismor pause lasts 24 hours by default; prismor resume ends it early. See Pause and resume.

Pinned rule

A rule shown with a lock on the Policy Control page. It belongs to Prismor's core safety floor or its self-protection rules, so you cannot turn it off for a project. See Making exceptions.

Plugin

A bundle that adds features to an agent, installed with the agent's own plugin command. Prismor lists plugins as one kind of extension. See Extension ledger.

Policy

The full set of rules and settings Prismor applies. Your project's version is the file .prismor/policy.yaml. It sits on top of Prismor's defaults, and an organization's policy can sit on top of both. See Policy layers and exemptions.

Risk score

A number from 0 to 100 for a session. It goes up with each finding, more for serious ones, and stops at 100. Use it to sort sessions and look at the riskiest first. See Dashboard.

Rule

One check in the policy, for example "do not read .env files". A rule has an id, a severity and an action (block, warn and so on). See Policy engine.

Rules fired

A dashboard count of every time a rule matched an action in the selected period, whether or not it blocked anything. One action can fire several rules. See Dashboard.

Scope / scoped agent / clear scope

At the start of a session, Prismor reads your first message and builds a small set of extra rules for that task only. This is the session's scope, and the feature is called the scoped agent. Clear scope (on the Sessions page, or prismor scope clear <id>) removes those session rules; your project and global policy still apply. See Scoped agent.

Session

One run of an agent, from start to finish. Prismor records every action in a session, so you can replay it later with prismor session <id> or on the Sessions page. See Dashboard.

Skill

A file of instructions, usually named SKILL.md, that an agent reads and follows. Because it can tell an agent what to do, Prismor tracks skills and flags new or changed ones. See Skill scanner and Extension ledger.

Supply chain

The packages and libraries your project installs from places like npm and PyPI. A bad package can run harmful code when installed. Prismor checks installs before they run. See Supply chain.

Tool call

A single action an agent takes, such as running a shell command, reading a file, writing a file or fetching a web page. Prismor checks each tool call. See Prismor.

Tool tag

A label that says what a tool does, such as untrusted_content (it reads outside input) or critical_action (it sends, publishes or deletes). Tag rules then forbid risky combinations, such as reading untrusted content and then acting on it. See Tool tags.

Turn

In a session timeline, one turn is one message you sent and everything the agent did in response, until your next message. See Dashboard.

Workspace

A project folder Prismor protects. Each one is registered when you install hooks in it, so the dashboard can show all of them together. A workspace can be personal or, on an enrolled machine, org-managed. See Dashboard: where the data lives and Connecting to the platform.