altimate-codex-plugin

Codex plugin that delegates dbt and warehouse work to altimate-code — a specialised CLI agent for column-level lineage, dbt build/test/run, warehouse profiling, FinOps reporting, cross-database validation, and connectivity to Snowflake / BigQuery / Redshift / Databricks / Postgres / MySQL / DuckDB.

What this gives your Codex agent

One skill: altimate-code — routes tasks that touch live warehouse state, column lineage, cross-database work, query-cost attribution, schema diffs, PII detection, or FinOps reporting to the altimate-code subprocess. The skill body encodes:

• how to check that altimate-code is installed
• which agent persona (fast-edit / analyst / builder) to pick for the task shape
• the exact non-interactive invocation with --yolo / --output / --dir
• when to add --continue for follow-up tasks in a warm session
• how to surface each failure mode to the user

The plugin also ships a SessionStart hook that emits a short routing hint into Codex's context so the model prefers delegation over reimplementing warehouse workflows with native tools.

Install

# 1. Add the marketplace to your Codex
codex plugin marketplace add AltimateAI/altimate-codex-plugin
# 2. Open Codex, type `/plugins`, select "Altimate Code", install
codex

You can also add a local clone or a different git ref:

codex plugin marketplace add ~/code/altimateai/altimate-codex-plugin # local path
codex plugin marketplace add AltimateAI/altimate-codex-plugin --ref main # pinned ref

To refresh:

codex plugin marketplace upgrade altimate-codex-plugin

To remove the marketplace registration:

codex plugin marketplace remove altimate-codex-plugin

Trusting the SessionStart hook

The plugin ships a SessionStart hook that injects a short routing hint into the model's context so it prefers the altimate-code skill for warehouse-touching work. Codex does not run plugin-bundled hooks automatically — the first time you start a session with the plugin installed, Codex will prompt you to review and trust the hook definition. Approve it once and the hook fires in every subsequent session; skip it and the plugin still installs but the routing hint won't be delivered.

Layout

altimate-codex-plugin/
├── .agents/plugins/
│ └── marketplace.json # marketplace registry pointing at ./plugins/altimate-code
└── plugins/altimate-code/
├── .codex-plugin/
│ └── plugin.json # plugin manifest
├── hooks/
│ ├── hooks.json # SessionStart hook definition
│ └── altimate-code-session-start.sh # hook script (routing hint)
└── skills/
└── altimate-code/SKILL.md # the one delegation skill

Companion CLI

The delegation skill spawns altimate-code as a subprocess. Install the companion CLI:

npm install -g altimate-code

Node 20+. After install, run altimate-code once to configure your LLM provider auth and warehouse connections through the TUI.

License & legal

• License: MIT — see LICENSE.
• Privacy:PRIVACY.md — what the plugin collects, what it doesn't, and where prompts go.
• Terms of use:TERMS.md — governs your use of the plugin and the connected Altimate services.
• Security disclosure:SECURITY.md — how to report a vulnerability.
• Contributing:CONTRIBUTING.md · Code of Conduct.