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

MIT — see LICENSE.