Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions .github/workflows/directory-package.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
name: Directory package

on:
pull_request:
push:
branches: [main]
workflow_dispatch:

permissions:
contents: read

jobs:
package:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
with:
python-version: '3.11'
- name: Test directory packaging
run: bash tests/directory-zip.sh
Comment thread
hkaltai marked this conversation as resolved.
Resolved
- name: Build skills-only directory ZIP
run: python3 scripts/build_directory_zip.py
- uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
with:
name: altimate-code-directory
path: dist/*.zip
if-no-files-found: error
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,5 @@
.scratch/
.github/meta/
*.log
dist/
__pycache__/
7 changes: 7 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,3 +118,10 @@ codex plugin marketplace remove altimate-codex-plugin
## Reporting bugs / requesting features

Please open a GitHub issue on this repo. For security-sensitive reports, see [SECURITY.md](./SECURITY.md).

## Directory package checks

Run `bash tests/directory-zip.sh` to exercise the real builder, validate archive
contents and listing images, and check reproducibility and rejection cases.
Run `python3 scripts/build_directory_zip.py` to produce the upload artifact.
See [DIRECTORY.md](DIRECTORY.md) before changing package inclusion rules.
27 changes: 27 additions & 0 deletions DIRECTORY-README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Altimate Code

This desktop plugin provides skills for dbt and warehouse work and dbt/SQL review.
Choose plugin setup or ask “Set up Altimate” to get started. Setup is user initiated.

The Altimate CLI is installed separately. Setup checks for `altimate-code` or
`altimate`, explains installation choices, and guides you to authenticate in your
own terminal. You can request the npm installation:

```sh
npm install -g @altimateai/altimate-code
```

For the standalone installer, follow the
[CLI installation instructions](https://github.com/AltimateAI/altimate-code)
in your own terminal. Then choose a dbt/warehouse task or request a dbt/SQL review.

This directory package excludes lifecycle hooks. For optional automatic session
behavior and workspace team rules, follow the
[full GitHub plugin installation](https://github.com/AltimateAI/altimate-codex-plugin#install).
Disable the directory copy first to avoid duplicate skills. Review and trust the
manual plugin's hooks before use. This is a guided switch, not an automatic upgrade.
To switch back, disable the manual copy and re-enable the directory copy.

Read [PRIVACY.md](PRIVACY.md) before enabling learning. The CLI and its provider
have separate authentication and data processing. See [TERMS.md](TERMS.md) and
[SECURITY.md](SECURITY.md), or [get support](https://github.com/AltimateAI/altimate-codex-plugin/issues).
89 changes: 89 additions & 0 deletions DIRECTORY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
# Altimate Code: directory installation

Altimate Code provides skills for dbt and warehouse work and dbt/SQL review.
The Altimate CLI must be installed separately. Run plugin setup (`get-started`)
to check the CLI, choose an installation method and configure authentication in
your terminal. Setup is user-initiated, not an automatic popup.

## Two distributions

| Capability | Public-directory ZIP | GitHub marketplace plugin |
|---|---|---|
| Altimate Code and review skills | Included, identical source files | Included |
| Guided setup skill and listing images | Included | Included |
| Lifecycle hooks and legacy commands | Excluded | Included |
| Local stdio MCP | Excluded by default; optional approved-partner build | Included when the source plugin provides it |
| Automatic team rules and optional learning | Not provided by this package | Requires trusted hooks, a linked workspace and a compatible CLI |

The GitHub plugin remains in `.codex-plugin/plugin.json` format. Do not add a
root Agent Plugins `plugin.json`: format changes can change hook loading.
The directory build derives a separate archive without modifying that source.

## Build from the repository

Run `python3 scripts/build_directory_zip.py`. The version comes from the source
manifest; the output is `dist/altimate-code-<version>.zip`. CI builds and uploads
this archive after its package tests pass. The archive root is the plugin root,
not a wrapping repository folder. Repeated builds of identical sources produce
identical bytes. Increase the source version for a new submission.

The builder includes only Markdown skills, image assets (with validated square
SVG listing icons), the legacy manifest,
the user-facing DIRECTORY-README.md (as README.md) and legal/security documents. It removes hooks, legacy commands,
app references and MCP registration, and sets `requires_local_executor: true`.
It rejects missing manifest-referenced icons and onboarding files, and unsupported
file types. It does not parse links or resource references inside skill Markdown;
check those manually during installation testing. New skills that require scripts need a deliberate
packaging change and tests before they can be included.

Only after OpenAI confirms local MCP eligibility for the submitting organization,
use `python3 scripts/build_directory_zip.py --include-local-mcp`. This requires a
source `.mcp.json` with stdio servers and creates a distinct `-local-mcp.zip`.
MCP `env` values must be `${VARIABLE}` references; literal values are rejected.
Only `mcpServers` is accepted at the top level, with `command`, `args`, `cwd`,
`env` and optional `type: "stdio"` per server. Unknown fields are rejected.
Commands and arguments use a deliberately small portable grammar: names and
relative paths containing ASCII letters, digits, underscores, dots, hyphens and
slashes; paths cannot contain empty, dot or parent components. `${PLUGIN_ROOT}`
may prefix a path. Options use `--name`, `-n`, or `--name=value`; glued path flags,
URI/colon syntax, other variables, absolute and home-relative paths are rejected.
Credential-named options must use environment references instead. This is not a
general-purpose secret scanner: review all names and arguments for secrets before
upload. Arbitrary shell expressions and launcher-specific syntax are unsupported.
The flag records the operator's choice; it cannot verify OpenAI allowlisting.
It does not add a server or bundle the separately installed CLI. Confirm that
external CLI dependency is accepted for your submission before uploading.

## Before submitting

The listing images use the existing Altimate gradient mark from
`AltimateAI/altimate-frontend`, `apps/web/src/assets/images/altimate_logo.svg`,
revision `854b86ad83d8d1a6cab576aab1dad1abfc573f78`.
The source SHA-256 is `d643aeef2a7ff3442901391f32b3f6bef280e9e8c7bcc164727030a0e93f6d1b`.
Only the outer SVG dimensions and viewBox differ: transparent square padding
centers the original artwork without changing its paths, gradients or colors.

- Complete organization/publisher identity verification and confirm submission
access. A successful build is not directory approval.
- Test a clean desktop install, setup and the actual skills using the built ZIP.
- Select the listing route before the first upload: OpenAI currently does not
support adding MCP to an existing skills-only listing. This builder does not
implement a remote HTTPS MCP service.
- If skills-only submissions are rejected, reply to the review email or contact
your OpenAI representative with the submission and organization IDs. Setting
`requires_local_executor` does not bypass eligibility requirements.
- Recheck the [submission rules](https://developers.openai.com/plugins/deploy/submission)
and [desktop-only rules](https://developers.openai.com/plugins/deploy/desktop-only).
Desktop-only directory installation is documented for the ChatGPT desktop app;
do not promise public-directory CLI installation.

## Optional hooks

For automatic session behavior, follow the
[GitHub installation instructions](https://github.com/AltimateAI/altimate-codex-plugin#install).
Disable the directory copy before enabling the manual plugin. Review and trust
hooks in `/hooks` in Codex CLI; new or changed definitions need review again.
Read [the privacy policy](https://github.com/AltimateAI/altimate-codex-plugin/blob/main/PRIVACY.md)
before enabling learning. To return to the directory version, disable the manual
plugin and re-enable the directory copy. The directory's core skills remain useful
without hooks; this optional flow must be disclosed during submission review.
9 changes: 8 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Codex plugin that delegates dbt and warehouse work to [`altimate-code`](https://

## What this gives your Codex agent

Two skills and matching slash commands. **`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:
Two task skills and matching slash commands, plus a `get-started` setup 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 resolve the CLI (`altimate-code`, falling back to `altimate`) and detect that it is not installed
- which agent persona (`fast-edit` / `analyst` / `builder`) to pick for the task shape
Expand Down Expand Up @@ -87,3 +87,10 @@ After install, run `altimate` once to configure your LLM provider auth and wareh
- **Terms of use:** [TERMS.md](./TERMS.md) — governs your use of the plugin and the connected Altimate services.
- **Security disclosure:** [SECURITY.md](./SECURITY.md) — how to report a vulnerability.
- **Contributing:** [CONTRIBUTING.md](./CONTRIBUTING.md) · [Code of Conduct](./CODE_OF_CONDUCT.md).

## Public directory package

The full GitHub installation retains lifecycle hooks. A separate build produces
a hook-free desktop directory ZIP with the same skills and guided setup.
See [DIRECTORY.md](DIRECTORY.md) for build commands, optional local MCP packaging,
and submission prerequisites. Building the archive does not publish a listing.
17 changes: 12 additions & 5 deletions plugins/altimate-code/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "altimate-code",
"version": "1.3.0",
"version": "1.4.0",
"description": "Delegates dbt and warehouse work to altimate-code, a specialized CLI agent with 100+ purpose-built data tools (SQL analysis, column-level lineage, dbt build/test/run, warehouse profiling, FinOps, connectivity to Snowflake, BigQuery, Redshift, Databricks, Postgres, MySQL, DuckDB).",
"author": {
"name": "Altimate AI",
Expand All @@ -22,10 +22,15 @@
],
"skills": "./skills/",
"commands": "./commands/",
"extensions": {
"com.openai": {
"onboardingSkill": "./skills/get-started/SKILL.md"
}
},
"interface": {
"displayName": "Altimate Code",
"shortDescription": "Delegate dbt + warehouse work to the altimate-code CLI agent",
"longDescription": "Routes data-engineering tasks — column-level lineage, cross-database validation, warehouse profiling, FinOps reporting, PII detection, dbt builds against real warehouses — to altimate-code, which already ships the specialised sub-skills internally. Ships two skills: `altimate-code` for delegation and `review` for dbt/SQL PR review with signed verdict envelopes. Use this plugin when you want Codex to hand a task to altimate-code rather than reimplement the workflow with native tools.",
"shortDescription": "dbt and warehouse workflows",
"longDescription": "Routes data-engineering tasks — column-level lineage, cross-database validation, warehouse profiling, FinOps reporting, PII detection, dbt builds against real warehouses — to altimate-code, which already ships the specialised sub-skills internally. Ships two task skills plus a `get-started` setup skill: `altimate-code` for delegation and `review` for dbt/SQL PR review with signed verdict envelopes. Use this plugin when you want Codex to hand a task to altimate-code rather than reimplement the workflow with native tools.",
"developerName": "Altimate AI",
"category": "Developer Tools",
"capabilities": [
Expand All @@ -36,10 +41,12 @@
"defaultPrompt": [
"Compare row counts between prod and staging in Snowflake.",
"Show column-level lineage for dim_customers.",
"Review my dbt changes.",
"Run altimate-code review on this PR."
"Review my dbt changes."
],
"websiteURL": "https://altimate.ai",
"supportURL": "https://github.com/AltimateAI/altimate-codex-plugin/issues",
"logo": "./assets/logo.svg",
"composerIcon": "./assets/composer-icon.svg",
"privacyPolicyURL": "https://altimate.ai/privacy",
"termsOfServiceURL": "https://altimate.ai/terms",
"brandColor": "#3B82F6"
Expand Down
8 changes: 8 additions & 0 deletions plugins/altimate-code/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@ All notable changes to the Altimate Code Codex plugin are recorded here.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.4.0] — 2026-11-17

- Add guided setup with an optional, explicitly chosen manual hooks installation.
- Add square listing images, support link, and directory-compatible listing text.
- Provide a reproducible directory ZIP build that excludes hooks and commands;
local MCP is excluded unless explicitly selected for an approved submission.
- Preserve the full GitHub plugin's legacy manifest and lifecycle hooks.

## [1.3.0] — 2026-11-12

### Added
Expand Down
24 changes: 24 additions & 0 deletions plugins/altimate-code/assets/composer-icon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 24 additions & 0 deletions plugins/altimate-code/assets/logo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading