Zephr Docs

Platform features

Zephr's platform is the foundation layer beneath product semantics: tenancy boundaries, credential planes, scope bindings, storage contracts, and the interface surface through which humans and AI agents interact with the system.

This section documents each platform capability with an honest status classification.

Status classifications

Every requirement and feature in this section carries one of seven status labels:

StatusMeaning
ShippedIn production, tested, and the source of truth for behaviour.
EvolvingThe foundation ships but a documented gap remains — the system works, but not all requirements are satisfied.
PlannedSpec-complete and reviewed, but not yet implemented or wired. The design exists in openspec/ as a tracked change.
DarkImplemented in code but not published, documented, or exposed to users. May be gated by a feature flag or an internal-only code path.
UnsupportedKnown to be absent or explicitly out of scope. No implementation exists and none is planned for the current release.
DeprecatedStill recognizable for migration, but no longer recommended.
UnverifiedEvidence is insufficient to make a stronger public claim.

Platform capabilities

CapabilityStatusPage
CLI, MCP server, daemon, editor integrationEvolvingSurfaces
Agent runtime — packs, tool tiers, context injectionEvolvingAgent runtime
Hosted tools — BYOK/metered external providersEvolvingHosted tools
Extensions — manifest, registry, hooks, signalsEvolvingExtensions
Universal integration — HTTP surface, host packsPlannedUniversal integration

Key identifiers

The platform uses the following canonical IDs throughout the codebase. These are not user-facing — they are the machine-readable contract between packages.

MCP tool tiers

The generated MCP tool reference is canonical for exact membership and residency. The current tiers are:

  • core: activate, constraint, get_observations, how_to_obtain, recall, remember, session, status, sync_status, timeline, tools_execute, tools_search.
  • search: search, grep, lsp, why, verify, graph_query.
  • docs: docs and files.
  • review: rules, admin, review, review_usage.
  • extension: verified extension tools; no default grant.
  • hosted: the external-provider catalog; no default grant.

Role policy controls tier grants. docs_writer is the documented role for docs-tier access; role IDs in configuration are opaque identifiers, not preset names.

Hosted tool IDs

Tool IDMCP nameProvider
context7context7_callLibrary documentation
firecrawlfirecrawl_scrapeWeb scraping
tavilytavily_searchWeb search
browserbrowser_renderBrowser snapshots
sentrysentry_queryError tracking
githubgithub_apiGitHub API
linearlinear_searchLinear issue tracker
supabasesupabase_querySupabase database

Credential modes

ModeMeaning
byokUser supplies their own API key; metered at provider cost
hostedZephr-supplied credential; metered at published retail rate