Code

praisonai code [OPTIONS] [PROMPT]

# Literal text
praisonai code --append-system-prompt "Always answer in French"

# Read the suffix from a file (@file form)
praisonai code --append-system-prompt @policy.md

export PRAISONAI_APPEND_SYSTEM_PROMPT="Reply in strict JSON, no prose."
praisonai code

cat data.json | praisonai code "Write a parser for this shape"

praisonai code -p "Write a Python function to sort a list" --output json

{"result": "def sort_list(items): return sorted(items)", "session_id": null, "usage": {"in": 128, "out": 42, "cost": 0.0}, "status": "ok"}

praisonai code -p "What is 2+2?" --output text
# 4

if praisonai code -p "Generate the release notes" --output text > notes.md; then
  echo "wrote notes.md"
else
  echo "generation failed" >&2
fi

praisonai code --resume my-feature -p "Draft the auth refactor" --output json
praisonai code --resume my-feature -p "Now add tests"          --output json

# Start a session in code, then continue it from run
praisonai code --session my-feature "Draft the auth refactor"
praisonai run --session my-feature "Now add tests"

# List and export the same session
praisonai session list
praisonai session export my-feature

praisonai code

praisonai code "Write a Python function to sort a list"

praisonai code --language python "Explain decorators"

praisonai code --no-safe "Refactor main.py"

praisonai code --dangerously-skip-approval "Clean up old logs"

# Machine-readable JSON envelope on stdout, status-reflecting exit code
praisonai code -p "Write a Python function to sort a list" --output json

# Add the `github` tool to a scripted coding run
praisonai code -p "Open a PR that fixes the failing lint" --tools github --output json

# Least-privilege review profile — instructions + permission scope from .praisonai/agents/reviewer.md
praisonai code -p --agent reviewer "Audit src/security/ for auth bugs" --output json

# Plan-only headless run — writes/edits/shell are denied
praisonai code -p --plan "Draft a migration plan for the auth module" --output json

# REPL session that can read/search but never writes or shells
praisonai code --plan "Draft a migration plan for the auth module"

praisonai code --thinking high "Refactor src/utils.py for readability"

# Profile defined in .praisonai/agents/plan.md
praisonai code --agent plan "Review the auth module and propose a refactor"

# Profile + reasoning effort combined
praisonai code --agent reviewer --thinking high "Audit src/security/"

praisonai code --append-system-prompt "Always answer in French"

praisonai code --workspace ./src "Refactor the auth module"

export PRAISONAI_WORKSPACE=/path/to/project
praisonai code "Add tests for user.py"

praisonai code --continue           # resumes the last session in its original directory
praisonai code --session abc123     # resumes that specific session in its original directory

⚠ Session workspace no longer exists: /old/path — using current directory instead.

# Windows PowerShell
$env:PRAISON_APPROVAL_MODE = "auto"
$env:PYTHONIOENCODING       = "utf-8"

praisonai code -w . --no-acp "Fix the failing tests"

praisonai code "Refactor auth module"

praisonai code --revert last

# agents.yaml
checkpoints:
  auto: true
  storage_dir: ./.praisonai/checkpoints   # optional — shared with praisonai run