Tham chiếu cấu hình

Tài liệu này được đối chiếu với Pi v1.0.0, commit a13d35a742c6ef8462812a28fbe1d8c8b7431c32.

Pi đọc setting JSON khi khởi động và khi reload resource. Reference này mô tả @earendil-works/pi-coding-agent 1.0.0 trên Node.js 22.19 trở lên.

File setting và thứ tự ưu tiên

Vị trí file

Bạn có thể sửa trực tiếp file JSON hoặc dùng /settings cho các lựa chọn interactive thông dụng. pi config quản lý package resource nào được bật; nó không phải trình sửa mọi setting. Xem Tùy chỉnh system prompt để biết quy tắc ghép prompt file riêng.

Merge và thứ tự ưu tiên CLI

Project setting override global setting theo cách đệ quy. Object lồng nhau merge theo key; array và scalar thay thế giá trị global. Sau đó, CLI argument chỉ override hành vi mà chính argument đó chỉ định trong process hiện tại. Ví dụ gồm --model, --thinking, --models, nhóm --tools, --use-theme, --tui-mode, --session-dir và các flag project trust.

Để chọn model, --provider cần --model; có thể dùng --model provider/model-id nếu muốn truyền một argument. Chỉ truyền --provider sẽ gây CLI error.

Hình dạng setting hiện tại

Package root public export SettingsManager và một số setting type, không export full schema validator. Các nhóm JSON hiện tại là:

Host nên dùng public getter khi cần giá trị có hiệu lực. Ví dụ runnable dưới đây cố ý bỏ qua project setting. SDK dùng trực tiếp không đọc CLI trust store; host phải tự resolve trust rồi truyền projectTrusted.

import { getAgentDir, SettingsManager } from "@earendil-works/pi-coding-agent";

const settings = SettingsManager.create(process.cwd(), getAgentDir(), {
  projectTrusted: false,
});

console.log({
  model: [settings.getDefaultProvider(), settings.getDefaultModel()],
  thinking: settings.getDefaultThinkingLevel(),
  tools: settings.getDefaultTools(),
  compaction: settings.getCompactionSettings(),
  retry: settings.getRetrySettings(),
  diagnostics: settings.drainErrors().map(({ scope, error }) => ({
    scope,
    message: error.message,
  })),
});

Model, thinking và tool

Model và thinking

defaultProvider và defaultModel xác định model mặc định. --model được ưu tiên cho một lần chạy; session được resume có thể khôi phục model đã ghi khi không truyền model tường minh qua CLI. defaultThinkingLevel nhận off, minimal, low, medium, high, xhigh hoặc max; setting này có thể được lưu bằng Ctrl+S trong /thinking hoặc sửa thủ công. Global default mang semantics cho lúc khởi động này tách biệt với request field của provider.

Model resolver cung cấp fallback khi cả lựa chọn tường minh lẫn trạng thái được resume đều không chỉ định model:

Đây là default cho xAI session mới hoặc trường hợp cần default resolution trong 1.0.0. Nó không thay thế model được chọn qua --model, chọn tương tác, cấu hình bằng defaultModel hoặc khôi phục từ session được resume.

modelThinkingLevels lưu thinking level khởi động theo từng model với khóa provider/modelId; hãy cấu hình qua /settings → Default thinking level per model hoặc sửa JSON thủ công. Giá trị khớp theo model chọn level khởi động của model đó, còn defaultThinkingLevel vẫn là global fallback. thinkingBudgets là setting riêng để cung cấp token budget cho provider hoặc compatible model có hỗ trợ.

Đừng nhầm các setting mang semantics đó với option gửi trực tiếp tới Google API. GoogleApiThinkingLevel, được export từ @earendil-works/pi-ai, là union kiểu enum hướng API "THINKING_LEVEL_UNSPECIFIED" | "MINIMAL" | "LOW" | "MEDIUM" | "HIGH" dùng cho GoogleOptions.thinking.level và GoogleVertexOptions.thinking.level. ResolvedGoogleThinkingLevel là union đã chuẩn hóa trong adapter "minimal" | "low" | "medium" | "high", dùng sau khi Pi resolve capability mapping của model. Cả hai type đều không mở rộng tập giá trị của defaultThinkingLevel; chúng mô tả các ranh giới trong mã provider.

import type {
  GoogleApiThinkingLevel,
  ResolvedGoogleThinkingLevel,
} from "@earendil-works/pi-ai";

const directRequestLevel: GoogleApiThinkingLevel = "HIGH";
const resolvedAdapterLevel: ResolvedGoogleThinkingLevel = "high";
void [directRequestLevel, resolvedAdapterLevel];

hideThinkingBlock ẩn thinking khỏi transcript. showCacheMissNotices hiện thông báo trong transcript cho prompt-cache miss đáng kể, mức sử dụng compaction hoặc branch summary, và chẩn đoán phục hồi provider như thinking block Anthropic bị loại. Model vẫn quyết định thinking level và budget nào được hỗ trợ.

enabledModels cung cấp pattern cho thao tác chuyển model bằng Ctrl+P; --models override scope đó trong một lần chạy. Provider endpoint và credential không nằm trong object setting providers. Hãy đặt endpoint được hỗ trợ trong ~/.pi/agent/models.json hoặc Provider configuration, đồng thời giữ credential trong authentication store hoặc environment được hỗ trợ. Xem Thêm một nhà cung cấp mô hình.

cacheWarming chỉ được đọc từ global setting vì refresh làm phát sinh provider usage. Giá trị mặc định "streaming" giữ cache đủ điều kiện còn hiệu lực khi Agent run đang active; "idle" có thể tiếp tục sau khi settle, còn "off" tắt warming. Điều kiện tham gia đến từ metadata cache lifetime trong promptCache của model cho retention tier đang dùng. Pi đánh giá mức tiết kiệm dự kiến trước mỗi refresh, nhưng warming vẫn tốn chi phí và không bảo đảm provider cache hit. /session hiển thị quyết định kế tiếp, còn showCacheMissNotices điều khiển transcript notice cho cache miss đáng kể, warming thành công, compaction usage và provider recovery.

Radius model discovery dùng ba lớp: catalog offline tích hợp sẵn có ngay, metadata gateway đã cache overlay lên lớp đó, rồi live gateway refresh overlay lên cả hai khi network thành công. Custom Radius gateway trong models.json dùng catalog riêng thay vì kế thừa catalog public của radius.pi.dev.

{
  "defaultProvider": "anthropic",
  "defaultModel": "claude-sonnet-4-6",
  "defaultThinkingLevel": "medium",
  "modelThinkingLevels": {
    "anthropic/claude-sonnet-4-6": "high"
  },
  "thinkingBudgets": {
    "minimal": 1024,
    "low": 4096,
    "medium": 10240,
    "high": 32768
  },
  "hideThinkingBlock": false,
  "showCacheMissNotices": true,
  "cacheWarming": "streaming"
}

Chọn tool

defaultTools chọn Tool lúc khởi động. Khi bỏ qua setting này, chính xác read, bash, edit và write là các mặc định được bật. Các built-in thông thường khác là powershell, grep, find và ls; powershell là shell Tool Windows native tùy chọn và không tự động được thêm. codemode cùng tool_search là các Tool inactive do built-in extension đăng ký và cũng có thể được nêu ở đây. Array rỗng bỏ các built-in mặc định nhưng vẫn để extension Tool và SDK custom Tool hoạt động. Tên thuần thay toàn bộ selection kế thừa; danh sách chỉ gồm entry +name và -name sẽ sửa selection đó theo thứ tự. Ví dụ ["-bash", "+powershell", "+grep"] thay Bash bằng PowerShell và thêm grep mà không cần lặp lại mọi Tool kế thừa. Project settings áp dụng cùng rule này trên user settings. --tools là allowlist nghiêm ngặt cho built-in, extension và custom Tool; nó cùng các CLI Tool switch khác override defaultTools cho invocation và không nhận ký hiệu thêm/bớt. Khi /reload, defaultTools activate tên mới thêm; nó không tắt tên đã bị xóa và không bật lại một Tool không đổi mà bạn đã tắt thủ công.

{
  "defaultTools": ["read", "bash", "edit", "write"]
}

Trên Windows, hãy chọn PowerShell tường minh, thay cho Bash hoặc cùng với Bash:

{
  "defaultTools": ["read", "powershell", "edit", "write"]
}

Chọn một Tool không thay đổi host shell đã khởi chạy Pi. Việc này chọn tên LLM-callable Tool nào đang active: bash gửi command đến backend tương thích Bash của Pi, còn powershell gửi command đến backend PowerShell native. Allowlist tools của CLI/SDK giữ cùng sự phân biệt này.

Các definition tích hợp sẵn read, bash, powershell, edit và write mặc định dùng JSON Schema constrained sampling ở chế độ strict-prefer. Provider không enforce được schema sẽ fallback về Tool calling thông thường. Extension thay một built-in definition có thể opt out tường minh bằng constrainedSampling: false.

Project trust

Giá trị fallback và quyết định đã lưu

Project trust kiểm soát việc load .pi/settings.json, resource trong project .pi, project package và extension thực thi được. defaultProjectTrust chỉ dùng ở global: ask là mặc định, còn always hoặc never cung cấp fallback ở non-interactive mode. Interactive startup sẽ hỏi khi có project resource cần trust và chưa có quyết định phù hợp. /trust ghi quyết định vào ~/.pi/agent/trust.json; hãy khởi động lại Pi để áp dụng cho project runtime hiện tại.

CLI resolve trust store trước khi tạo trusted runtime. SettingsManager.create() được SDK host gọi trực tiếp mặc định projectTrusted là true và không bao giờ đọc trust.json; host nhạy cảm về security nên truyền quyết định tường minh.

Override cho một lần chạy

--approve (-a) trust file cục bộ của project trong một lần chạy. --no-approve (-na) bỏ qua chúng trong một lần chạy. Print, JSON và RPC mode không thể hiện trust prompt, nên chúng dùng quyết định đã lưu phù hợp, global fallback hoặc một trong hai flag này.

Project trust là ranh giới cho project resource, không phải per-tool approval. Setting hiện tại không có switch yolo, permissions hoặc requiresPermission. Hãy áp dụng chính sách duyệt hoặc chặn tool trong embedding host hay Extension tool_call.

Compaction và retry

Compaction và branch summary

Hai setting cũ compaction.threshold theo tỉ lệ và preserveRecentTurns theo số turn không còn tồn tại. Compaction hiện dùng token reserve và recent-token budget.

Trong compaction.modelOverrides, reserveTokens và keepRecentTokens fallback độc lập sang compaction value thông thường, rồi built-in default. Key phải khớp chính xác và phân biệt chữ hoa chữ thường, kể cả slash bên trong model ID. Chỉ field bị bỏ qua mới fallback; value phải là số nguyên an toàn không âm, và override khớp nhưng không hợp lệ sẽ gây lỗi.

Retry và message delivery

retry.enabled, maxRetries (3) và baseDelayMs (2000) điều khiển agent-level retry. retry.provider.timeoutMs, maxRetries và maxRetryDelayMs (60000) điều khiển provider layer. Provider retry mặc định bằng 0 trong tích hợp Coding Agent; tăng ở cả hai layer có thể nhân số request và khiến failure xuất hiện chậm.

steeringMode và followUpMode nhận one-at-a-time (mặc định) hoặc all. transport nhận auto, sse, websocket hoặc websocket-cached. httpIdleTimeoutMs mặc định 300000; 0 tắt HTTP idle timeout. websocketConnectTimeoutMs điều khiển opening handshake và cũng nhận 0 để tắt.

Session, terminal và shell

Session storage

sessionDir thay đổi nơi lưu persistent session. Relative path được resolve từ working directory của process, còn ~ được mở rộng thành home directory. Khi không có override, Pi lưu một file JSONL append-only cho mỗi session dưới ~/.pi/agent/sessions/<encoded-cwd>/.

Không có setting tích hợp sessions.retention hoặc sessions.redactSecrets. Ứng dụng vận hành Pi chịu trách nhiệm về file permission, backup, retention và deletion; hãy bảo vệ session JSONL vì nó có thể chứa prompt, model output và tool result. Xem Duy trì session.

/bug [description] là runtime command, không phải một nhóm settings.json. Command che secret value khỏi metadata đã thu thập, rồi cho phép kèm transcript tùy chọn, dùng summary do model viết, upload lên Radius hoặc xuất ZIP local. Offline mode chặn upload nhưng vẫn cho xuất ZIP local. Crash metadata được giữ trong ~/.pi/agent/crashes.json cho report tiếp theo; hãy bảo vệ file này và mọi ZIP đã xuất như diagnostic data.

Terminal, image, shell và npm

terminal.showImages (true) điều khiển inline display, imageWidthCells (60) đặt chiều rộng ưu tiên, clearOnShrink (false) xóa hàng không còn dùng, còn showTerminalProgress (false) phát progress indicator khi terminal hỗ trợ. images.blockImages (false) chặn mọi image gửi đến provider. Ẩn image trong terminal không chặn upload.

images.autoResize là global gate để bật hoặc tắt. model.inputLimits.images.resize là override tùy chọn theo từng field. Pi lấy fallback runtime làm nền rồi ghi đè từng field được cung cấp; nếu không có profile thì Pi dùng toàn bộ fallback, còn profile không đầy đủ vẫn giữ fallback cho từng field còn thiếu:

Giới hạn thực tế có thể khác nhau theo từng model. Profile đang active được dùng cho file attachment, image do read trả về và Tool-result image. Mỗi image mới chỉ được normalize một lần khi đi vào history; việc chọn model khác về sau không ghi lại nội dung đã lưu. Provider-side transformation và hard limit nằm ngoài profile này của Pi, vì vậy cần kiểm tra riêng theo từng route.

Pi tự động detect terminal capability và nhận chính xác các giá trị environment cùng setting sau:

Với PI_HYPERLINKS, 1 buộc bật OSC 8 hyperlink, 0 buộc tắt chúng, còn auto chuyển sang tự động detect. terminal.hyperlinks setting tường minh được ưu tiên hơn cả PI_HYPERLINKS lẫn kết quả detect tự động; "auto" không tạo setting override.

Với PI_IMAGE_PROTOCOL, kitty chọn protocol Kitty và iterm2 chọn protocol iTerm2; none buộc tắt inline image, còn auto chuyển sang tự động detect. Một protocol tường minh hoặc false trong terminal.images setting được ưu tiên hơn cả PI_IMAGE_PROTOCOL lẫn kết quả detect tự động; "auto" không tạo setting override.

Với PI_TRUE_COLOR, 1 buộc bật truecolor, 0 buộc tắt nó, còn auto chuyển sang tự động detect. terminal.trueColor setting tường minh được ưu tiên hơn cả PI_TRUE_COLOR lẫn kết quả detect tự động; "auto" không tạo setting override.

Force capability không được hỗ trợ ở bất kỳ đoạn nào trên đường đi qua terminal, proxy hay multiplexer có thể phát escape sequence không được hỗ trợ và làm hỏng rendering. Cơ chế detect nhận diện integrated terminal của Zed có truecolor và hyperlink nhưng không có inline image protocol, nên auto dùng image text fallback tại đó.

shellPath chọn executable cho Tool bash, shellCommandPrefix thêm prefix vào mọi command bash, còn npmCommand là argv array cho package operation. Các setting dành cho Bash này không activate, cấu hình hay thay thế Tool powershell; hãy chọn PowerShell trong defaultTools, --tools hoặc option tools của SDK. Path Windows trong JSON cần dùng dấu gạch chéo xuôi hoặc escape dấu gạch chéo ngược.

{
  "terminal": {
    "showImages": true,
    "imageWidthCells": 60,
    "clearOnShrink": false,
    "showTerminalProgress": false,
    "hyperlinks": "auto",
    "images": "auto",
    "trueColor": "auto"
  },
  "images": {
    "autoResize": true,
    "blockImages": false
  },
  "shellPath": "C:/Program Files/Git/bin/bash.exe",
  "shellCommandPrefix": "shopt -s expand_aliases",
  "npmCommand": ["mise", "exec", "node@22", "--", "npm"],
  "sessionDir": ".pi/sessions"
}

Interface và output

--mode nhận text, json hoặc rpc. Pi 1.0.0 coi cả giá trị bị thiếu lẫn giá trị không hợp lệ là CLI error thay vì fallback sang interactive mode:

Validation này chạy trước khi session bắt đầu, vì vậy mode viết sai sẽ thất bại rõ ràng trong script và CI.

UI và display

theme, externalEditor, quietStartup và collapseChangelog điều khiển startup và cách trình bày. quietStartup: "header" giữ header với version và gợi ý phím nhưng ẩn phạm vi model cùng danh sách resource đã tải; true ẩn cả header lẫn phần chi tiết. externalEditor override VISUAL, rồi EDITOR; dùng code --wait khi Pi cần chờ VS Code. doubleEscapeAction nhận tree, fork hoặc none, còn treeFilterMode chọn filter mặc định cho /tree.

system theme là default và dựng palette từ màu terminal. Custom theme chấp nhận đúng sáu dạng màu: RGB hex 3-digit như #0af, RGB hex 6-digit như #00aaff, OKLCH, OKHSL, ANSI 256 index từ 0 đến 255, variable reference, hoặc empty string "" để dùng terminal default. Hai cách viết RGB là một dạng hexadecimal; variable reference bị thiếu hoặc tạo vòng lặp làm theme không hợp lệ.

editorPaddingX được clamp từ 0 đến 3, outputPad là 0 hoặc 1, còn autocompleteMaxVisible được clamp từ 3 đến 20. showHardwareCursor hỗ trợ nhập bằng IME. tuiMode nhận regular hoặc fullscreen và mặc định là fullscreen; chọn tuiMode: "regular" trong setting hoặc --tui-mode regular cho một lần chạy để tắt fullscreen. Các key flat liên quan là fullscreenExitOutput (transcript hoặc resume-hint) và fullscreenScrollbar (auto, always hoặc hidden). Hai shape lồng cũ tui.* và fullscreen.* không còn dùng. Thời gian chờ phím Escape là environment control được mô tả ở Biến môi trường.

fullscreenCopyOnSelect mặc định là true, nên drag selection ở fullscreen được copy tự động. Khi setting này bị tắt, selection vẫn active và được highlight; Ctrl+X thử copy selection đang active đủ điều kiện rồi kết thúc action bất kể clipboard write thành công hay thất bại. Action chỉ fallback sang assistant message cuối khi không có selection đang active đủ điều kiện. Setting này chỉ tác động đến text selection trong fullscreen, còn /tree vẫn giữ hành vi copy message đang được chọn.

fullscreenWheelScrollLines nhận "auto" hoặc một số từ 1 đến 100. Auto mode di chuyển một dòng mỗi event trên terminal macOS local, nơi wheel/trackpad đã tự tăng tốc; ở nơi khác và qua SSH, nó tăng tốc wheel input nhanh lên tối đa sáu dòng mỗi event. Alt+wheel di chuyển gấp năm lần khoảng cách đã resolve.

Control có thể click Jump to latest message chỉ xuất hiện khi fullscreen transcript đã scroll lên phía trên message mới nhất; control nằm ở hàng dưới cùng và hiển thị shortcut tui.altScreen.bottom. Với fullscreenScrollbar: "auto", scrollbar hiện ra trong lúc scroll hoặc khi pointer đi vào track ở cột ngoài cùng bên phải. Click vào track sẽ nhảy qua transcript; always luôn dành cột và hiển thị scrollbar, còn hidden loại bỏ nó.

Markdown và warning

markdown.codeBlockIndent mặc định là hai dấu cách. markdown.mermaid nhận off, final hoặc streaming (mặc định). warnings.anthropicExtraUsage mặc định true và điều khiển cảnh báo extra usage của subscription.

Network, telemetry và update

httpProxy áp dụng HTTP_PROXY và HTTPS_PROXY cho HTTP client do Pi quản lý và chỉ được đọc từ global setting. Đừng nhúng proxy credential vào project file. Stream timeout và transport setting đã được liệt kê ở phần retry và message delivery.

enableInstallTelemetry mặc định true cho version ping ẩn danh khi install/update. enableAnalytics là opt-in và mặc định false; Pi tạo trackingId khi opt-in. Các setting này không tắt update check. collapseChangelog thay đổi cách hiện changelog, còn lastChangelogVersion là state do Pi quản lý và không nên sửa bằng tay. Dùng PI_SKIP_VERSION_CHECK hoặc offline mode cho network policy; xem Biến môi trường để biết control chính xác.

Resource, package và glob

Danh sách resource và package filter

extensions, skills, prompts và themes chứa local path hoặc directory. Trong global setting, relative path được resolve từ ~/.pi/agent; trong project setting, nó được resolve từ .pi. Các array này hỗ trợ glob, exclusion !pattern, force-include +path và force-exclude -path. enableSkillCommands điều khiển việc đăng ký thành /skill:name và mặc định true.

Các identifier chính xác của built-in extension là builtin:mcp, builtin:llama.cpp, builtin:codemode và builtin:tool-search. Chúng được load mặc định; dùng -builtin:mcp (hoặc exact name tương ứng) để tắt một extension, và dùng +builtin:<name> hay -builtin:<name> trong project settings để override resource selection ở user level. --no-extensions tắt chúng cùng các extension khác, còn -e builtin:<name> load tường minh một extension.

Entry của MCP server nằm trong mcp.json, tách khỏi settings.json. Với HTTP server có authorization-server discovery sai hoặc thiếu, override trong cấu hình Coding Agent là oauth.authServerMetadataUrl. Metadata document được cấu hình sẽ được tin cậy và phải dùng HTTPS, trừ loopback host.

Dùng packages cho nguồn npm hoặc Git; đừng đặt package name vào extensions. Package entry dạng string tự load mọi resource. Dạng object có thể đặt autoload: false và lọc extensions, skills, prompts hoặc themes. Project resource và thao tác cài project package còn thiếu vẫn chịu project trust.

{
  "packages": [
    "@org/pi-resources",
    {
      "source": "git:github.com/org/team-pi-resources",
      "autoload": false,
      "skills": ["review", "release"],
      "extensions": []
    }
  ],
  "extensions": ["./extensions/*.ts", "!./extensions/legacy.ts"],
  "skills": ["+./skills/release/SKILL.md", "!./skills/experimental/**"],
  "prompts": ["./prompts/*.md"],
  "themes": ["./themes/*.json"],
  "enableSkillCommands": true
}

Ví dụ đầy đủ và project override

Global file này bao quát các nhóm thông dụng mà không chứa provider credential:

{
  "defaultProvider": "anthropic",
  "defaultModel": "claude-sonnet-4-6",
  "defaultThinkingLevel": "medium",
  "thinkingBudgets": {
    "minimal": 1024,
    "low": 4096,
    "medium": 10240,
    "high": 32768
  },
  "hideThinkingBlock": false,
  "showCacheMissNotices": true,
  "cacheWarming": "streaming",
  "enabledModels": ["anthropic/*", "openai/gpt-5.2*"],
  "defaultTools": ["read", "bash", "edit", "write"],
  "theme": "dark",
  "quietStartup": true,
  "tuiMode": "regular",
  "fullscreenCopyOnSelect": true,
  "markdown": {
    "codeBlockIndent": "  ",
    "mermaid": "final"
  },
  "compaction": {
    "enabled": true,
    "reserveTokens": 16384,
    "keepRecentTokens": 20000,
    "modelOverrides": {
      "some-provider/large-context-model": {
        "reserveTokens": 400000
      }
    }
  },
  "branchSummary": {
    "reserveTokens": 16384,
    "skipPrompt": false
  },
  "retry": {
    "enabled": true,
    "maxRetries": 3,
    "baseDelayMs": 2000,
    "provider": {
      "maxRetries": 0,
      "maxRetryDelayMs": 60000
    }
  },
  "steeringMode": "one-at-a-time",
  "followUpMode": "one-at-a-time",
  "transport": "auto",
  "httpIdleTimeoutMs": 300000,
  "websocketConnectTimeoutMs": 15000,
  "sessionDir": ".pi/sessions",
  "terminal": {
    "showImages": true,
    "hyperlinks": "auto",
    "images": "auto",
    "trueColor": "auto"
  },
  "images": {
    "autoResize": true,
    "blockImages": false
  },
  "warnings": {
    "anthropicExtraUsage": true
  },
  "packages": ["@org/pi-resources"]
}

Với ví dụ merge, bắt đầu từ global file này:

{
  "theme": "dark",
  "compaction": {
    "enabled": true,
    "reserveTokens": 16384,
    "keepRecentTokens": 20000
  },
  "defaultTools": ["read", "bash", "edit", "write"]
}

Sau đó thêm trusted project override:

{
  "compaction": {
    "reserveTokens": 8192
  },
  "defaultTools": ["read"]
}

Kết quả giữ theme, compaction.enabled và keepRecentTokens, đổi reserveTokens, đồng thời thay toàn bộ array defaultTools.

Kiểm tra và tiếp tục

Pi parse JSON và báo load failure dưới dạng settings warning. Pi không expose command pi --dry-run đã ngừng dùng, full-schema validator public hay setting logPrompts. Ở lần load đầu, scope lỗi không đóng góp setting; khi reload, SettingsManager giữ giá trị hợp lệ gần nhất của scope đó và expose lỗi qua drainErrors(). Unknown field không chứng minh config hợp lệ, vì vậy hãy kiểm tra giá trị có hiệu lực bằng public getter và chạy runtime path liên quan. Guide về system prompt trình bày các API inspect prompt hiện tại.

Sau khi sửa trong interactive session, dùng /reload; SDK host có thể await settingsManager.reload(). Tiếp theo, xem API reference hoặc Biến môi trường.