Configuration

nosh stores configuration in ~/.config/nosh/. The main config file is config.toml.

Configuration File

# ~/.config/nosh/config.toml

# AI configuration
[ai]
context_size = 10            # Recent exchanges to include as context
agentic_enabled = true       # Enable agentic mode (??)
max_iterations = 10          # Max commands per agentic query
timeout = 0                  # Agentic timeout in seconds (0 = no timeout)

# History settings
[history]
load_count = 200             # Commands to load on startup

# Prompt theme
[prompt]
theme = "builtins/default"   # Built-in theme
syntax_highlighting = true   # Highlight shell input as you type
# theme = "mytheme"          # Local theme (in ~/.config/nosh/themes/)
# theme = "awesome-pkg/dark" # Package theme (from /install)

Init Script

For shell customizations like aliases and environment variables, edit ~/.config/nosh/init.sh:

# ~/.config/nosh/init.sh

# Aliases
alias ll='ls -la'
alias gs='git status'
alias gp='git push'

# Environment
export EDITOR=vim
export PATH="$HOME/.local/bin:$PATH"

# Custom functions
mkcd() {
    mkdir -p "$1" && cd "$1"
}

Directory Structure

~/.config/nosh/
├── config.toml              # Main configuration
├── credentials.toml         # API credentials (auto-generated)
├── permissions.toml         # Command permissions
├── history.db               # Command history (SQLite)
├── init.sh                  # Shell initialization script
├── themes/                  # Your local themes (from /create)
├── plugins/
│   └── community/           # Your local plugins (from /create)
└── packages/
    ├── builtins/            # Built-in themes, plugins, completions
    │   ├── themes/
    │   ├── plugins/
    │   └── completions/
    └── {package-name}/      # Git-installed packages

Slash Commands

Command	Description
/setup	Run setup wizard to sign in
/usage	Show usage, balance, manage subscription
/buy	Buy tokens or subscribe to a plan
/config	Open or edit config files
/create	Create or link a nosh package
/install user/repo	Install package from GitHub
/upgrade	Upgrade nosh to latest version
/sync	Sync config, builtins, and packages
/packages	List and manage installed packages
/convert-zsh FILE	Convert zsh completion to TOML
/clear	Clear AI conversation context
/reload	Reload config and theme
/help	Show help

Query Syntax

Syntax	Description
command	Run command directly
?query	Translate natural language via AI
??query	Agentic mode - AI investigates before answering

Environment Variables

Variable	Description
NOSH_CONFIG_DIR	Override config directory
NOSH_CLOUD_URL	Override cloud API URL (for development)
NOSH_DEBUG	Enable debug output