Configuration

Zcrafter is designed to be zero-configuration for most users. All your settings are managed automatically through the interactive interface.

Configuration Storage

Zcrafter saves your preferences, API keys, and connection details in a secure JSON file located at: ~/.Zcrafter.json

Important: You generally do not need to edit this file manually. Zcrafter updates it automatically when you change settings in the app.

What is Configured?

The configuration file stores:

1. Providers: Your API keys for OpenAI, Anthropic, etc.
2. Agents: Which model is assigned to which agent (e.g., using Claude for coding and GPT-4o for tasks).
3. Mainframe: Your saved host, port, and username for z/OS connections.
4. UI Preferences: Your chosen theme and avatar.

Environment Variables (Advanced)

For users who want to automate their setup (e.g., in a CI/CD pipeline or dotfiles), Zcrafter supports environment variables. These override the settings in the config file.

Resetting Configuration

If you ever need to clear your settings (e.g., to remove an invalid API key), use the built-in command:

1. Press Ctrl+D to open the Command Palette.
2. Select Reset API Key.

This is safer and easier than deleting the configuration file manually.