truefoundry

TrueFoundry Deploy Skills

Deploy, monitor, and manage ML infrastructure on TrueFoundry using AI coding assistants.

Works as a plugin for Claude Code and Codex CLI (with enforced workflows, automatic health verification, and failure diagnosis), and as rules + skills for Cursor.

Quick Start

Prerequisites

Set your TrueFoundry credentials via environment variables or a .env file in your project root:

export TFY_BASE_URL=https://your-org.truefoundry.cloud
export TFY_API_KEY=tfy-...

No account yet? Run uv run tfy register to sign up. The tfy CLI and workspace selection are handled automatically -- skills install the CLI if missing and list your available workspaces at deploy time.

Claude Code (Plugin -- Full Enforcement)

Add the marketplace and install the plugin:

/plugin marketplace add truefoundry/tfy-deploy-skills
/plugin install truefoundry@truefoundry-deploy-skills

Or interactively: /plugin → Discover tab → select truefoundry → Install now.

What you get:

• 22 skills loaded automatically
• 2 specialized agents (deploy orchestrator, troubleshoot)
• 5 hooks enforcing safe deployment workflows
• Automatic credential checks on session start
• Post-deploy health verification and failure diagnosis

Codex CLI (Plugin -- Full Enforcement)

Clone the repo and point Codex at it, or install via the Codex plugin system:

codex install truefoundry/tfy-deploy-skills

Enable hooks in your config.toml:

codex_hooks = true

Same hooks and skills as Claude Code. Agents are defined in AGENTS.md for Codex.

Cursor (Rules -- Advisory)

Copy the skills into Cursor's config directory:

npx skills add truefoundry/tfy-deploy-skills -g -a cursor -s '*' -y

What you get:

• 22 skills as context rules
• No hook enforcement (Cursor does not support hooks)
• Skills provide guidance but cannot block unsafe operations

Standalone Skills (Any Agent)

For any agent that supports the Agent Skills open format:

npx skills add truefoundry/tfy-deploy-skills -g -a claude-code -a cursor -a codex -s '*' -y

Or install for all detected agents:

npx skills add truefoundry/tfy-deploy-skills --all

What You Can Do

Just ask your agent in plain English:

• "deploy my FastAPI app"
• "launch a Jupyter notebook with a GPU"
• "deploy Postgres with Helm"
• "deploy an LLM with vLLM"
• "show logs for my-service"
• "what's my connection status?"

What's Included

22 Skills

Category	Skills
Deploy	applications, deploy, gitops, helm, jobs, llm-deploy, ml-repos, notebooks, service-test, ssh-server, tracing, volumes, workflows, workspaces
Operate	logs, monitor, status
Manage	access-control, access-tokens, docs, onboarding, secrets

Installed skill names are namespaced as truefoundry-<skill> (e.g., truefoundry-deploy).

Plugin Hooks (Claude Code and Codex)

Hook	Type	What It Does
Session Start	SessionStart	Verifies credentials, auto-installs/upgrades the tfy CLI, tests API connectivity, lists accessible workspaces
Block Deletes	PreToolUse	Blocks all DELETE API calls -- redirects users to the TrueFoundry dashboard for manual deletion
Auto-Approve API	PreToolUse	Auto-approves tfy-api.sh and tfy-version.sh calls so the agent does not prompt for each API request
Secret Scan	PreToolUse	Blocks commands containing hardcoded API keys, tokens, or credentials -- enforces tfy-secret:// references
Deploy Monitor	PostToolUse	Detects tfy apply/tfy deploy commands, polls deployment status with adaptive intervals, fetches logs on failure, verifies health on success
Verification Gate	Stop	Prevents the agent from finishing if a deployment is in progress or an endpoint is unreachable

Agents (Claude Code)