Commands

Command Line Usage

agenticode [options] [prompt]

Global Options

Option	Alias	Type	Default	Description
--model	-m	string	(wizard)	Model to use
--ollama-host	-o	string	(wizard)	Ollama server URL
--directory	-d	string	cwd	Working directory
--non-interactive	-n	boolean	false	Skip setup wizard
--json	-j	boolean	false	JSON output mode
--ui	-	string	ink	UI: 'ink' or 'classic'
--yolo	-y	boolean	false	Auto-approve all tools
--system-prompt	-s	string	-	Custom system prompt
--system-prompt-file	-	string	-	System prompt from file
--api-endpoint	-	string	-	AgenticWork API URL
--api-key	-	string	-	AgenticWork API key
--provider	-	string	auto	Provider: 'api', 'ollama', 'auto'
--alt-buffer	-	boolean	false	Use alternate screen
--output-format	-	string	text	Output: 'text' or 'stream-json'
--input-format	-	string	text	Input: 'text' or 'stream-json'
--version	-V	-	-	Show version
--help	-h	-	-	Show help

Usage Examples

Interactive Session

# With setup wizard
agenticode

# Skip wizard with specific model
agenticode -m gpt-4o -n

# Use specific Ollama host
agenticode -o http://192.168.1.100:11434

One-Off Prompts

# Simple prompt
agenticode "explain this code"

# With model selection
agenticode -m claude-3-5-sonnet "write a fibonacci function"

# With custom working directory
agenticode -d /path/to/project "fix the tests"

YOLO Mode

Auto-approve all tool executions (use with caution):

agenticode --yolo "create a new React component"

Custom System Prompt

# Inline prompt
agenticode -s "You are a Python expert" "optimize this function"

# From file
agenticode --system-prompt-file ./prompts/python-expert.txt

JSON/Streaming Modes

For integration with other tools:

# NDJSON output (for web UIs)
agenticode --output-format stream-json --input-format stream-json

# JSON output (non-interactive)
agenticode -n -j "list files in src/"

Provider Selection

# Force Ollama
agenticode --provider ollama

# Force API
agenticode --provider api --api-endpoint https://api.agenticwork.io

# Auto-detect (default)
agenticode --provider auto

Exit Codes

Code	Meaning
0	Success
1	General error
130	Interrupted (Ctrl+C)

Environment Variables

These can be set instead of CLI options:

# API Configuration
export AGENTICWORK_API_ENDPOINT=https://api.agenticwork.io
export AGENTICODE_API_KEY=your-api-key

# Model Configuration
export AWCODE_MODEL=gpt-4o
export AWCODE_TEMPERATURE=0.7
export AWCODE_MAX_TOKENS=4096

# Feature Flags
export AWCODE_SHELL_ENABLED=true
export AWCODE_FILE_WRITE_ENABLED=true
export AWCODE_MCP_ENABLED=true

# System Prompt
export AGENTICODE_SYSTEM_PROMPT="You are helpful"
export AGENTICODE_SYSTEM_PROMPT_FILE=/path/to/prompt.txt

# Session
export AGENTICODE_SESSION_ID=session-123