jac-config

Configure jac.toml sections, dependencies, profiles, and CLI settings for Jac projects.

Updated Jul 26, 2026
One-click install
npx skills add https://github.com/PMN123/trapdoor --skill jac-config-pmn123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jac-config
Source: https://github.com/PMN123/trapdoor/tree/main/.agents/skills/jac-config
Command: npx skills add https://github.com/PMN123/trapdoor --skill jac-config-pmn123

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Jac projects centralize all settings in a single jac.toml file, but its many sections, per-key hyphen/underscore conventions, and CLI verbs are easy to get wrong, causing silently ignored settings and misconfigured builds. ## Core Features & Use Cases - Complete section reference: Documents every jac.toml table including [project], [dependencies], [serve], [run], [check.lint], [test], [byllm], [scale], [client], [desktop], and capability tables. - Dependency and config CLI verbs: Covers jac install/remove/update for PyPI, npm, and git packages plus jac config get/set/list for reading and writing settings. - Profiles and interpolation: Explains ${VAR} environment variable interpolation and JAC_PROFILE-based environment overrides with inheritance. - Use Case: When adding an AI model to a Jac app, consult this Skill to correctly write the [byllm.model] table with an interpolated API key, then run jac install to pull litellm into .jac/venv. ## Quick Start Ask the assistant to load the jac-config skill and help you add a production environment profile with caching enabled to your jac.toml.

Frequently Asked Questions about jac-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure jac.toml for a Jac project?

Edit jac.toml sections directly or use jac config set for individual keys, such as jac config set serve.port 3000. Generate the initial file with jac create, then verify any hand-edited key with jac config get since wrong key forms are silently ignored.

How do I install dependencies in a Jac project?

Run jac install <pkg> to install a PyPI package and record it in [dependencies] with an auto-pinned ~=major.minor spec. Use --dev for dev tools, --git for git URLs, and run jac install after editing dependency tables by hand.

How do environment profiles work in Jac?

Define [environments.<name>] tables in jac.toml and activate one with JAC_PROFILE=production or the --profile flag on jac run, start, or test. Profiles can inherit from each other via the inherits key and override any section values.

Why is my jac.toml setting being ignored?

Hyphen versus underscore usage is per-key and unforgiving: entry-point and requires-python use hyphens while fail_fast and base_route_app use underscores. A wrong form fails silently, so confirm the parsed value with jac config get <key>.

Can I use environment variables in jac.toml?

Yes, ${VAR} interpolation works in any string value, with ${VAR:-default} for fallbacks and ${VAR:?message} for required variables. A common use is storing API keys like api_key = "${OPENAI_API_KEY}" in [byllm.model].