From truefoundry-gateway
Checks TrueFoundry connection status and verifies credentials (TFY_BASE_URL, TFY_HOST, TFY_API_KEY) using Bash and tfy-api.sh. Use as preflight before platform operations like deployments.
npx claudepluginhub truefoundry/tfy-gateway-skills --plugin truefoundry-gatewayThis skill is limited to using the following tools:
> Routing note: For ambiguous user intents, use the shared clarification templates in [references/intent-clarification.md](references/intent-clarification.md).
references/api-endpoints.mdreferences/cli-fallback.mdreferences/cluster-discovery.mdreferences/container-versions.mdreferences/gpu-reference.mdreferences/health-probes.mdreferences/intent-clarification.mdreferences/manifest-defaults.mdreferences/manifest-schema.mdreferences/prerequisites.mdreferences/resource-estimation.mdreferences/rest-api-manifest.mdreferences/tfy-api-setup.mdscripts/tfy-api.shscripts/tfy-version.shGuides new users through TrueFoundry account registration, email verification, credential configuration, and first API setup. Activates on phrases like 'get started', 'set up truefoundry', 'register', or missing credentials.
Runs shell scripts to check deployment health, service connectivity (Vercel, Railway, Redis, PostgreSQL), validate environment variables, and perform pre-deploy smoke tests with structured JSON output.
Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.
Share bugs, ideas, or general feedback.
Routing note: For ambiguous user intents, use the shared clarification templates in references/intent-clarification.md.
Check TrueFoundry connection and verify credentials are configured.
Verify TrueFoundry credentials and connectivity, or diagnose authentication issues before performing platform operations.
workspaces skill; ask if the user wants another valid path| Variable | Description | Example |
|---|---|---|
TFY_BASE_URL | TrueFoundry platform URL | https://your-org.truefoundry.cloud |
TFY_HOST | CLI host alias (recommended when TFY_API_KEY is set for CLI commands) | https://your-org.truefoundry.cloud |
TFY_API_KEY | API key (raw, no Bearer prefix) | tfy-... |
If the TrueFoundry tool server is available, use this tool call:
tfy_config_status
This returns connection status, configured base URL, and whether an API key is set.
Check environment variables and test the connection. Set TFY_API_SH to the full path of this skill's scripts/tfy-api.sh. See references/tfy-api-setup.md for paths per agent.
# Check env vars are set
echo "TFY_BASE_URL: ${TFY_BASE_URL:-(not set)}"
echo "TFY_HOST: ${TFY_HOST:-(not set)}"
echo "TFY_API_KEY: ${TFY_API_KEY:+(set)}${TFY_API_KEY:-(not set)}"
# Test connection — list workspaces (lightweight call). Use full path shown above.
# Example for Claude Code:
~/.claude/skills/truefoundry-status/scripts/tfy-api.sh GET '/api/svc/v1/workspaces?limit=1'
If env vars are not set, check for a .env file:
[ -f .env ] && echo ".env found" || echo "No .env file"
TrueFoundry Status:
- Base URL: https://your-org.truefoundry.cloud ✓
- API Key: configured ✓
- Connection: OK (listed 1 workspace)
Or if something is wrong:
TrueFoundry Status:
- Base URL: (not set) ✗
- API Key: (not set) ✗
Set TFY_BASE_URL and TFY_API_KEY in your environment or .env file.
If you do not have a TrueFoundry account yet, run: uv run tfy register
That flow may open a browser for CAPTCHA or human verification before email verification completes.
Get an API key: https://docs.truefoundry.com/docs/generating-truefoundry-api-keys
<success_criteria>
</success_criteria>
API key is invalid or expired. Generate a new one:
https://docs.truefoundry.com/docs/generating-truefoundry-api-keys
Cannot reach TFY_BASE_URL. Check:
- URL is correct (include https://)
- Network/VPN is connected
TFY_BASE_URL and TFY_API_KEY are required.
Set them via environment variables or add to .env in project root.
If the user is new to TrueFoundry, have them run `uv run tfy register` first,
complete any browser-based CAPTCHA or human verification it requests, verify their email,
open the returned tenant URL, and create a PAT there.
TFY_HOST error)If tfy CLI says: "TFY_HOST env must be set since TFY_API_KEY env is set"
run: export TFY_HOST="${TFY_HOST:-${TFY_BASE_URL%/}}"
tfy_config_set to persist credentials