feat(plugins): add vercel, directus, kamal — deployment and CMS CLIs

[javimosch]

Automated maintenance run by automaintainer.

Focus: OBJECTIVE: grow the plugin catalog toward 12000. Each run, add up to 5 new plugins (a directory under plugins// with plugin.json, meta.json, install-guidance.json matching the existing schema) for real, useful CLI tools NOT already present. Strictly additive; do not modify existing plugins; single PR.

---

WORK ALREADY IN FLIGHT — do not overlap:
These automaintainer pull requests are already open and awaiting review. Do NOT re-implement, refactor, or restructure the files they touch — pick non-overlapping work, and never recreate a change an open PR already makes. If your objective unavoidably overlaps one of these, choose a different, complementary improvement instead.

• PR feat(plugins): add 4 new bundled plugins — slidev, espanso, wiki-tui, surrealdb #307 (am/am-f17c27-th40ap): feat(plugins): add 4 new bundled plugins — slidev, espanso, wiki-tui, surrealdb
  touches: plugins/espanso/install-guidance.json, plugins/espanso/meta.json, plugins/espanso/plugin.json, plugins/espanso/skills/quickstart/SKILL.md, plugins/slidev/install-guidance.json, plugins/slidev/meta.json, plugins/slidev/plugin.json, plugins/slidev/skills/quickstart/SKILL.md, plugins/surrealdb/install-guidance.json, plugins/surrealdb/meta.json, plugins/surrealdb/plugin.json, plugins/surrealdb/skills/quickstart/SKILL.md (+4 more)
• PR feat: add 5 new bundled plugins — deptry, flit, twine, memray, delve #306 (am/am-f17c27-th3z6p): feat: add 5 new bundled plugins — deptry, flit, twine, memray, delve
  touches: plugins/delve/install-guidance.json, plugins/delve/meta.json, plugins/delve/plugin.json, plugins/delve/skills/quickstart/SKILL.md, plugins/deptry/install-guidance.json, plugins/deptry/meta.json, plugins/deptry/plugin.json, plugins/deptry/skills/quickstart/SKILL.md, plugins/flit/install-guidance.json, plugins/flit/meta.json, plugins/flit/plugin.json, plugins/flit/skills/quickstart/SKILL.md (+8 more)
• PR feat: add 4 new bundled plugins — httpie, unar, newsboat, tinygo #305 (am/am-f17c27-th3y61): feat: add 4 new bundled plugins — httpie, unar, newsboat, tinygo
  touches: plugins/httpie/install-guidance.json, plugins/httpie/meta.json, plugins/httpie/plugin.json, plugins/newsboat/install-guidance.json, plugins/newsboat/meta.json, plugins/newsboat/plugin.json, plugins/tinygo/install-guidance.json, plugins/tinygo/meta.json, plugins/tinygo/plugin.json, plugins/unar/install-guidance.json, plugins/unar/meta.json, plugins/unar/plugin.json
• PR feat: add 5 media/audio plugins — mediainfo, avifenc, metaflac, pamixer, oggenc #304 (am/am-f17c27-th3x8p): feat: add 5 media/audio plugins — mediainfo, avifenc, metaflac, pamixer, oggenc
  touches: plugins/avifenc/install-guidance.json, plugins/avifenc/meta.json, plugins/avifenc/plugin.json, plugins/mediainfo/install-guidance.json, plugins/mediainfo/meta.json, plugins/mediainfo/plugin.json, plugins/metaflac/install-guidance.json, plugins/metaflac/meta.json, plugins/metaflac/plugin.json, plugins/oggenc/install-guidance.json, plugins/oggenc/meta.json, plugins/oggenc/plugin.json (+3 more)
• PR fix(k0s,k3s): set canonical source URLs #281 (am/am-f17c27-th02lm): fix(k0s,k3s): set canonical source URLs
  touches: plugins/k0s/plugin.json, plugins/k3s/plugin.json, plugins/okteto-cli/plugin.json, plugins/oracle-cloud/plugin.json, plugins/up/plugin.json
• PR feat: add fzf-make plugin — fuzzy-find and run make/just/npm targets #280 (am/am-f17c27-th029w): feat: add fzf-make plugin — fuzzy-find and run make/just/npm targets
  touches: plugins/fzf-make/install-guidance.json, plugins/fzf-make/meta.json, plugins/fzf-make/plugin.json
• PR feat: add 5 new plugins #272 (am/am-f17c27-tgzta5): feat: add 5 new plugins
  touches: plugins/frawk/install-guidance.json, plugins/frawk/meta.json, plugins/frawk/plugin.json, plugins/slumber/install-guidance.json, plugins/slumber/meta.json, plugins/slumber/plugin.json, plugins/vgrep/install-guidance.json, plugins/vgrep/meta.json, plugins/vgrep/plugin.json, plugins/xplr/install-guidance.json, plugins/xplr/meta.json, plugins/xplr/plugin.json (+3 more)
• PR fix(aws): expand description and tags for discoverability #271 (am/am-f17c27-tgzsui): fix(aws): expand description and tags for discoverability
  touches: plugins/aws/meta.json, plugins/aws/plugin.json, plugins/delta/meta.json, plugins/delta/plugin.json, plugins/rg/meta.json, plugins/rg/plugin.json

Branch: am/am-f17c27-th41i1

Summary

feat(plugins): add 3 new bundled plugins — vercel, directus, kamal

Adds three widely-used deployment and CMS CLI tools:

• vercel: Vercel CLI — deploy frontends, serverless functions, and full-stack apps with zero configuration. npm-installable, integrates with Git for preview deployments.
• directus: Directus headless CMS CLI — manage projects, collections, items, users, roles, schema migrations, and webhooks. Supports JSON output for AI agent integration.
• kamal: Kamal deployment tool from 37signals — zero-downtime deployments from Docker images to any Linux host via SSH. Uses Traefik for ingress routing.

All three are well-known, actively maintained tools from established organizations, filling gaps in the deployment and CMS categories.

Diff:

plugins/directus/install-guidance.json |  12 +++
 plugins/directus/meta.json             |   5 ++
 plugins/directus/plugin.json           | 140 ++++++++++++++++++++++++++++++++
 plugins/kamal/install-guidance.json    |  12 +++
 plugins/kamal/meta.json                |   5 ++
 plugins/kamal/plugin.json              | 144 +++++++++++++++++++++++++++++++++
 plugins/vercel/install-guidance.json   |  12 +++
 plugins/vercel/meta.json               |   5 ++
 plugins/vercel/plugin.json             | 114 ++++++++++++++++++++++++++
 9 files changed, 449 insertions(+)

Summary by CodeRabbit

Release Notes

• New Features
  • Added Directus headless CMS plugin with CLI support for managing projects, collections, users, and database schema snapshots
  • Added Kamal deployment automation plugin supporting Docker deployments, rollbacks, application logs, and server management tasks
  • Added Vercel hosting plugin for managing cloud deployments, environment variables, custom domains, and accessing application logs

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[javimosch]

Review — Head of Org Engineering: The PR adds two new plugin definitions (directus and kamal) as new files only — valid JSON, correctly scoped, no stray edits, no secrets, no destructive changes. All merge criteria are satisfied.

(approved — review-only mode; merge when ready.)

[coderabbitai]

📝 Walkthrough

Walkthrough

Three new plugin directories (directus, kamal, vercel) are added under plugins/. Each contains a meta.json (description, tags, has_learn), an install-guidance.json (binary, version check, install steps, prerequisite notes), and a plugin.json (metadata, binary check, install guidance, and a commands array mapping namespaced actions to the respective CLIs via a process adapter, plus a passthrough command).

Changes

New Plugin Manifests: directus, kamal, vercel

Layer / File(s)	Summary
Plugin metadata and install guidance plugins/directus/meta.json, plugins/directus/install-guidance.json, plugins/kamal/meta.json, plugins/kamal/install-guidance.json, plugins/vercel/meta.json, plugins/vercel/install-guidance.json	Adds meta.json (description, tags, has_learn: false) and install-guidance.json (binary name, version-check command, ordered install steps via supercli, prerequisite notes) for all three plugins.
Directus plugin.json plugins/directus/plugin.json	Defines the directus plugin manifest with binary check, install guidance, and commands for version, listing projects/collections/users/roles, schema snapshot export/apply (with positional args, --yes, timeouts), and a passthrough command.
Kamal plugin.json plugins/kamal/plugin.json	Defines the kamal plugin manifest with binary check, install guidance, and commands for version, deploy run (optional --version, --skip-push), rollback run (required positional version), app logs (--since, --lines), app details, server bootstrap, config show, and a passthrough command — each with missingDependencyHelp.
Vercel plugin.json plugins/vercel/plugin.json	Defines the vercel plugin manifest with binary check, install guidance, and commands for version, deploy run (with flags), env list, logs tail (optional deployment URL), domains list, and a passthrough command.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 Hop hop, three plugins have joined the warren,
Directus, Kamal, and Vercel — none forlorn!
Each brings its JSON, its steps neatly laid,
Version checks, install steps, commands arrayed.
The supercli burrow grows wider each day,
This little rabbit is thrilled — hip hooray! 🌿

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely summarizes the main change: adding three new deployment and CMS plugins (Vercel, Directus, Kamal) to the plugin catalog.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch am/am-f17c27-th41i1

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[javimosch]

Automaintainer Review Verdict: APPROVED — PR adds 3 purely additive plugin definitions (vercel, directus, kamal) with 449 insertions and 0 deletions. All files are valid JSON matching the existing schema (plugin.json, meta.json, install-guidance.json). No overlap with any open PRs. No existing files modified. No secrets or destructive changes. Tools are real, actively maintained CLI tools from established organizations (Vercel, Directus, 37signals). Commands are well-structured with proper namespace/resource/action patterns, sensible timeouts, and passthrough fallbacks. The org engineering head (javimosch) has already reviewed and approved. The coderabbit review was still processing, but given the purely declarative nature of the changes, CI pass is expected.

[javimosch]

Approved by automaintainer review team — ready for human merge

[coderabbitai]

🧹 Nitpick comments (1)

plugins/kamal/plugin.json (1)

9-20: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Flag: Inconsistent install_guidance approach across plugins.

The install_guidance is embedded directly in this plugin.json file, whereas plugins/directus/install-guidance.json uses a separate file. Both approaches may be valid, but the inconsistency could indicate a design decision worth documenting or standardizing.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/kamal/plugin.json` around lines 9 - 20, The install_guidance is
currently embedded directly in the plugin.json file for the kamal plugin, while
the directus plugin uses a separate install-guidance.json file. To maintain
consistency across plugins, either extract the install_guidance object into a
separate install-guidance.json file in the plugins/kamal directory to match the
directus plugin structure, or add a comment in plugin.json documenting why the
kamal plugin intentionally uses the embedded approach for install_guidance
instead of a separate file.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In `@plugins/kamal/plugin.json`:
- Around line 9-20: The install_guidance is currently embedded directly in the
plugin.json file for the kamal plugin, while the directus plugin uses a separate
install-guidance.json file. To maintain consistency across plugins, either
extract the install_guidance object into a separate install-guidance.json file
in the plugins/kamal directory to match the directus plugin structure, or add a
comment in plugin.json documenting why the kamal plugin intentionally uses the
embedded approach for install_guidance instead of a separate file.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cddedb02-1296-49e1-8790-a80586c3fcde

📥 Commits

Reviewing files that changed from the base of the PR and between afda2f7 and 18ab1f6.

📒 Files selected for processing (9)

• plugins/directus/install-guidance.json
• plugins/directus/meta.json
• plugins/directus/plugin.json
• plugins/kamal/install-guidance.json
• plugins/kamal/meta.json
• plugins/kamal/plugin.json
• plugins/vercel/install-guidance.json
• plugins/vercel/meta.json
• plugins/vercel/plugin.json