Skip to main content

Prompts and config.yaml

Two ways to customize Knox besides AGENTS.md and skills: prompt files (extra / commands) and config.yaml (models, providers, context, optional uses: includes).

Prompt files as slash commands​

Markdown files in:

PathScope
.knoxcoder/promptsThis project
~/.knoxcoder/promptsThis machine

They appear under Prompts in the / picker, not under Commands. The command name is what you type after /. Create one from the Prompts overlay (Add Prompt) or drop a file in that folder.

Prompt files are only applied when you invoke them as a slash command. They are not always-on instructions (use AGENTS.md for that).

config.yaml​

Knox: Settings → Open Config File, or edit:

PathRole
~/.knoxcoder/config.yamlUser models, providers, some agent config, optional hooks:
.knoxcoder/config.yamlOptional project overlay

Editing from the GUI keeps a one-time config.yaml.vpre-edit.bak. Knox never rewrites the file on upgrade.

A minimal local model (also covered on Sign in and models):

name: Knox
version: "1.0.0"
schema: v1
models:
- name: Local Llama
provider: openai
model: llama3
apiBase: http://127.0.0.1:11434/v1
apiKey: ollama

name is the title in the composer and in knoxchat.fallbackModel.

You can also declare context: providers, prompts:, rules:, and hooks: in YAML. Prefer .knoxcoder/hooks.json for project hooks so they are obvious in the repo.

uses: owner/package (local registry only)​

A block may say uses: owner/package (optionally owner/package@version). Knox loads YAML from this machine:

~/.knoxcoder/registry/owner/package.yaml
~/.knoxcoder/registry/owner/package@version.yaml

(KNOX_GLOBAL_DIR replaces ~/.knoxcoder.) If the file is missing, that is an error, not a network call.

Remote registries are not supported in 2.2. There is no package download, no scheduled agents, and no MCP servers inside KnoxCoder.

Copy a YAML snippet into registry/owner/ yourself, or inline the models in config.yaml.

What does not belong in config.yaml​

Don’tWhy
KNOX_API_KEYNot read in 2.2 — OAuth or BYO key
Marketplace ~/.knox pathsDifferent product
Embedding / vector memory settingsMemory Brain is local lexical retrieval

Next​

Sign in and models · Skills · Settings reference