docs: install the Claude Code plugin from Altimate's marketplace, and document its panes

SA
11h ago
+27-12

What

  • The README and the "Using with Claude Code" guide install the plugin from Altimate's marketplace (claude plugin marketplace add AltimateAI/altimate-claude-plugin, then claude plugin install altimate-code@altimate-claude-plugin). The bare claude plugin install altimate-code they gave before installs Anthropic's directory copy, which is pinned several versions behind and has none of the lineage pane or the dbt helpers.
  • The guide gets a Lineage, cost, health and more section under the dbt helpers: the lineage pane, the scan cost check (/scan-cost, /allow-scan), project health (/health), team comments (/comments), /runs, /profile-ctes, /sql-graph, /to-model, /defer and /target, and /propagate. Each bullet says what runs, when, and what it needs (the dbt adapter, a warehouse query, an Altimate sign-in, DataPilot). The guide only covered the five 1.8.0 helpers before.
  • Both say the helpers need altimate-code 0.12.12 or later, the release that shipped the dbt Power User tools they call, and link to that section of the dbt tools page.

Checks

  • mkdocs build --strict passes; the new in-page anchors and the link to dbt-tools.md#dbt-power-user-tools resolve in the built site.
  • Feature descriptions were taken from the plugin's hooks/features/*.tsx headers and command registrations on altimate-claude-plugin main, and from the 0.12.12 CHANGELOG for what each CLI tool runs.

Companion plugin PR: documents the same features in the plugin README and raises its prerequisite to 0.12.12.

🤖 Generated with Claude Code

https://claude.ai/code/session_01XM3J9kD6sRhQQyPAe2BVyn


Summary by cubic

Updates the Claude Code plugin install and guide to use Altimate's marketplace instead of Anthropic's pinned directory copy, and documents the plugin's full set of panes and commands.

  • The README and "Using with Claude Code" guide now install via claude plugin marketplace add AltimateAI/altimate-claude-plugin and claude plugin install altimate-code@altimate-claude-plugin; Anthropic's directory copy is pinned at 1.0.0, without the dbt helpers or lineage pane.
  • The guide adds a Lineage, cost, health and more section covering the lineage pane, /scan-cost and /allow-scan, /health, /comments, /runs, /profile-ctes, /sql-graph, /to-model, /defer and /target, and /propagate, with what each runs and requires.
  • The plugin runs from altimate-code 0.12.11; only the dbt Power User commands need 0.12.12 or later.
  • The panes call tools through altimate tool run only, never the plugin's MCP server.

Summary by CodeRabbit

  • Documentation
    • Updated Claude Code setup instructions with minimum Altimate Code version requirements, marketplace installation guidance, and details about Anthropic’s pinned plugin copy, including how to identify and remove it.
    • Expanded the guide with information about dbt helpers and plugin panes, commands, prerequisites, and behavior, including lineage, project health, SQL workflows, and documentation propagation.
    • Clarified that dbt helpers run the project’s own dbt, distinct from the plugin’s dbt tools.