Skip to content

Praxis Runtime

GitHub · praxis-runtime

Praxis Runtime is a local MCP server exposing tools for role workflows. Desktop distribution is an MCPB; Claude Code CLI requires its own documented MCP registration and a connection check. A connected role plugin does not by itself prove Runtime is connected.

  • Packaged as claude-extensions/praxis-runtime.mcpb
  • Configured in Claude Desktop (jira_base_url, jira_email, jira_project_key, jira_token, optional github_token / gitlab_token)
  • Exposes public tools such as praxis_doctor, praxis_ba_preview, praxis_developer_complete

Claude Desktop does not reliably inherit launchctl setenv or shell .env into the MCP child. That path failed after alpha.30. Desktop users configure user_config, not environment inheritance.

Quality is started by praxis_quality_ensure from server/praxis-quality.cjs in the same MCPB. In Claude Desktop it runs inside the Runtime process. Under a normal node CLI it is a detached child. Users do not start it themselves, and they do not install Node or SQLite for it.

CLI and CI can use PRAXIS_JIRA_* where that launch path documents them. Runtime operates on one selected local project root at a time; it does not import a sibling product repository or assign technical permissions by installed role. The Desktop Runtime catalog may expose the tool union, so role ownership is a workflow convention, not a security boundary.

See CLI setup for Claude Code users.

See Installation and Secrets.