From 1272ca6909f570609063622a393815233542d5a2 Mon Sep 17 00:00:00 2001
From: Codeplane Agent
Date: Sun, 31 May 2026 21:26:16 +0000
Subject: [PATCH 1/2] fix(i18n): fill missing translations in Japanese and
Korean locale files
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- app/ja.ts: restored Japanese translations for provider OAuth visit prefixes
("Visit ") that had been left as a formatting space
- ui/ja.ts: filled empty lineComment label/editorLabel prefixes
("行目: ", "コメント編集中: ")
- ui/ko.ts: filled empty lineComment label/editorLabel prefixes
("라인 ", "편집 중 ")
All 652 app and 51 UI i18n parity tests pass. Lint shows 0 errors.
Co-Authored-By: codeplane-agent[bot] <287208015+codeplane-agent[bot]@users.noreply.github.com>
---
packages/app/src/i18n/ja.ts | 4 ++--
packages/ui/src/i18n/ja.ts | 4 ++--
packages/ui/src/i18n/ko.ts | 4 ++--
3 files changed, 6 insertions(+), 6 deletions(-)
diff --git a/packages/app/src/i18n/ja.ts b/packages/app/src/i18n/ja.ts
index 69e295053..b302a509f 100644
--- a/packages/app/src/i18n/ja.ts
+++ b/packages/app/src/i18n/ja.ts
@@ -132,14 +132,14 @@ const translated = {
"provider.connect.apiKey.label": "{{provider}} APIキー",
"provider.connect.apiKey.placeholder": "APIキー",
"provider.connect.apiKey.required": "APIキーが必要です",
- "provider.connect.oauth.code.visit.prefix": " ",
+ "provider.connect.oauth.code.visit.prefix": "アクセス: ",
"provider.connect.oauth.code.visit.link": "このリンク",
"provider.connect.oauth.code.visit.suffix": " にアクセスして認証コードを取得し、アカウントを接続してCodeplaneで{{provider}}モデルを使用してください。",
"provider.connect.oauth.code.label": "{{method}} 認証コード",
"provider.connect.oauth.code.placeholder": "認証コード",
"provider.connect.oauth.code.required": "認証コードが必要です",
"provider.connect.oauth.code.invalid": "無効な認証コード",
- "provider.connect.oauth.auto.visit.prefix": " ",
+ "provider.connect.oauth.auto.visit.prefix": "アクセス: ",
"provider.connect.oauth.auto.visit.link": "このリンク",
"provider.connect.oauth.auto.visit.suffix": " にアクセスし、以下のコードを入力してアカウントを接続し、Codeplaneで{{provider}}モデルを使用してください。",
"provider.connect.oauth.auto.confirmationCode": "確認コード",
diff --git a/packages/ui/src/i18n/ja.ts b/packages/ui/src/i18n/ja.ts
index 4938a9fd0..1c536bffe 100644
--- a/packages/ui/src/i18n/ja.ts
+++ b/packages/ui/src/i18n/ja.ts
@@ -27,9 +27,9 @@ const translated = {
"ui.fileMedia.binary.title": "バイナリファイル",
"ui.fileMedia.binary.description.path": "{{path}} はバイナリファイルのため表示できません。",
"ui.fileMedia.binary.description.default": "このファイルはバイナリファイルのため表示できません。",
- "ui.lineComment.label.prefix": "",
+ "ui.lineComment.label.prefix": "行目: ",
"ui.lineComment.label.suffix": "へのコメント",
- "ui.lineComment.editorLabel.prefix": "",
+ "ui.lineComment.editorLabel.prefix": "コメント編集中: ",
"ui.lineComment.editorLabel.suffix": "へのコメントを作成中",
"ui.lineComment.placeholder": "コメントを追加",
"ui.lineComment.submit": "コメント",
diff --git a/packages/ui/src/i18n/ko.ts b/packages/ui/src/i18n/ko.ts
index e7e44f3e5..4606f491b 100644
--- a/packages/ui/src/i18n/ko.ts
+++ b/packages/ui/src/i18n/ko.ts
@@ -29,9 +29,9 @@ const translated = {
"ui.fileMedia.binary.title": "바이너리 파일",
"ui.fileMedia.binary.description.path": "{{path}}은(는) 바이너리 파일이므로 표시할 수 없습니다.",
"ui.fileMedia.binary.description.default": "바이너리 파일이므로 표시할 수 없습니다.",
- "ui.lineComment.label.prefix": "",
+ "ui.lineComment.label.prefix": "라인 ",
"ui.lineComment.label.suffix": "에 댓글 달기",
- "ui.lineComment.editorLabel.prefix": "",
+ "ui.lineComment.editorLabel.prefix": "편집 중 ",
"ui.lineComment.editorLabel.suffix": "에 댓글 작성 중",
"ui.lineComment.placeholder": "댓글 추가",
"ui.lineComment.submit": "댓글",
From b733603150aecb146eefca2631d69d84cbc748f6 Mon Sep 17 00:00:00 2001
From: Codeplane Agent
Date: Sun, 31 May 2026 22:11:01 +0000
Subject: [PATCH 2/2] fix(docs): fill CLI reference gaps and complete
configuration schema docs
CLI reference:
- Add totp command (generate, uri, code subcommands with flags) to synopsis
and new dedicated section; totp was an implemented but undocumented
public subcommand.
- Add generate to synopsis and update Generated/Hidden section to
accurately describe its describe:false hidden status.
- Update metadata (title, openGraph, twitter) to list totp alongside
the other documented subcommands so SEO metadata matches the synopsis.
- completion subcommand was already documented; no structural change
there beyond the metadata alignment.
Configuration reference:
- Add disabled_providers and enabled_providers to the top-level shape
JSON example and the runtime behavior table.
- Add username, default_agent, npm, and watcher to the top-level shape
JSON example (all present in packages/codeplane/src/config/config.ts
but missing from the page's example block).
- Add a new dedicated npm section with registry/authToken example and
explanation of {secret} / {env} placeholder support.
- Add compaction.tail_turns, compaction.reserved, disabled_providers,
enabled_providers, username, and default_agent to the runtime behavior
table (all defined in config.ts, none of which were listed).
- Round out the compaction example to include the new tail_turns and
reserved keys.
Verification:
- bun --cwd site run typecheck (pass)
- bun --cwd site run build (pass)
- bun --cwd packages/app test --preload ./happydom.ts ./src (652 pass)
- bun --cwd packages/ui test (362 pass)
Co-Authored-By: codeplane-agent[bot] <287208015+codeplane-agent[bot]@users.noreply.github.com>
---
site/app/docs/cli/page.tsx | 26 ++++++++++++++++++++------
site/app/docs/configuration/page.tsx | 25 ++++++++++++++++++++++++-
2 files changed, 44 insertions(+), 7 deletions(-)
diff --git a/site/app/docs/cli/page.tsx b/site/app/docs/cli/page.tsx
index a7e4b3a9d..98bb4f5a2 100644
--- a/site/app/docs/cli/page.tsx
+++ b/site/app/docs/cli/page.tsx
@@ -4,17 +4,17 @@ import { DocsLayout } from "@/components/docs-sidebar"
export const metadata = {
title: "CLI reference",
- description: "Every Codeplane subcommand and flag, sourced from packages/codeplane/src/cli — serve, web, tui, instance, upgrade, completion.",
+ description: "Every Codeplane subcommand and flag, sourced from packages/codeplane/src/cli — serve, web, tui, instance, upgrade, totp, completion.",
alternates: { canonical: "/docs/cli/" },
openGraph: {
title: "CLI reference · Codeplane",
- description: "Every Codeplane subcommand and flag, sourced from packages/codeplane/src/cli — serve, web, tui, instance, upgrade, completion.",
+ description: "Every Codeplane subcommand and flag, sourced from packages/codeplane/src/cli — serve, web, tui, instance, upgrade, totp, completion.",
url: "/docs/cli/",
type: "article",
},
twitter: {
title: "CLI reference · Codeplane",
- description: "Every Codeplane subcommand and flag, sourced from packages/codeplane/src/cli — serve, web, tui, instance, upgrade, completion.",
+ description: "Every Codeplane subcommand and flag, sourced from packages/codeplane/src/cli — serve, web, tui, instance, upgrade, totp, completion.",
card: "summary_large_image",
},
}
@@ -41,6 +41,8 @@ Commands:
tui start the terminal UI
instance manage saved Codeplane instances + the shared local runtime
upgrade [target] upgrade Codeplane to the latest (or a specific) version
+ totp manage two-factor (TOTP) auth for the server
+ generate regenerate the OpenAPI spec (SDK build pipeline)
completion generate shell completion script
Top-level options (accepted by every subcommand):
@@ -110,6 +112,18 @@ Top-level options (accepted by every subcommand):
instance-daemon.ts. New flags land in code first, then on this page.
+ codeplane totp
+ Manage the second factor for serve / web. The generated secret is
+ passed via CODEPLANE_SERVER_TOTP_SECRET or --totp-secret.
+ {`codeplane totp
+
+ generate generate a new TOTP secret and enrolment URI
+ flags: --account, --issuer
+ uri --secret <s> print the otpauth:// URI for an existing secret
+ flags: --secret, --account, --issuer
+ code --secret <s> print the current 6-digit code (debug)
+ flags: --secret`}
+
codeplane upgrade
{`codeplane upgrade [target]
@@ -163,9 +177,9 @@ codeplane completion fish > ~/.config/fish/completions/codeplane.fish`}
Generated and hidden commands
- codeplane generate is intentionally hidden from normal help. It is used by
- the SDK build pipeline to emit OpenAPI data for client generation. Treat it as a build
- command, not a public automation API.
+ codeplane generate is hidden from normal help (describe: false).
+ It is used by the SDK build pipeline to emit OpenAPI data for client generation. Treat it
+ as a build command, not a public automation API.
Exit codes
diff --git a/site/app/docs/configuration/page.tsx b/site/app/docs/configuration/page.tsx
index 29751e3c8..c0423e8fe 100644
--- a/site/app/docs/configuration/page.tsx
+++ b/site/app/docs/configuration/page.tsx
@@ -62,6 +62,8 @@ export default function Configuration() {
"server": { /* default serve/web network options */ },
"model": "anthropic/claude-sonnet-4-6",
"small_model": "openai/gpt-5.2-mini",
+ "disabled_providers": ["example-provider"],
+ "enabled_providers": ["anthropic", "openai"],
"provider": { /* model providers and overrides */ },
"permission": { /* what the agent may do without asking */ },
"agent": { /* named primary and sub-agent configs */ },
@@ -72,8 +74,12 @@ export default function Configuration() {
"commit": { "coauthor": false },
"autoupdate": "notify",
"share": "manual",
+ "username": "custom-display-name",
+ "default_agent": "build",
+ "npm": { /* native npm auth and registry settings */ },
+ "watcher": { "ignore": ["node_modules/", "dist/"] },
"tool_output": { "max_lines": 2000, "max_bytes": 51200 },
- "compaction": { "auto": true, "prune": true }
+ "compaction": { "auto": true, "prune": true, "tail_turns": 2, "reserved": 1000 }
}`}
server
@@ -127,6 +133,17 @@ export default function Configuration() {
OpenAI-compatible endpoints.
+ npm
+ {`"npm": {
+ "registry": "https://registry.npmjs.org",
+ "authToken": "{secret:npm-auth-token}"
+}`}
+
+ Override the npm registry and supply an auth token for private registries. Used by the
+ local-runtime downloader and any plugin that shells out to npm. Values support{" "}
+ {`{secret:name}`} and {`{env:VAR}`} placeholders.
+
+
permission
{`"permission": {
"read": "allow",
@@ -264,14 +281,20 @@ export default function Configuration() {
| Key | Values | Use it for |
+ username | string | Custom name shown in conversations instead of the system username. |
+ default_agent | string | Primary agent to use when none is specified (falls back to build). |
share | manual, auto, disabled | Control public session sharing. |
autoupdate | true, false, notify | Auto-install patches or show update notifications. |
commit.coauthor | true, false | Add Co-Authored-By: codeplane-agent[bot] <287208015+codeplane-agent[bot]@users.noreply.github.com> so GitHub shows the codeplane-agent app as a co-author. |
snapshot | true, false | Enable filesystem snapshots for revert/undo. |
+ disabled_providers | string array | Catalog providers to hide from the model selector. |
+ enabled_providers | string array | When set, only these providers are loaded; all others are ignored. |
tool_output.max_lines | positive integer | Truncate long tool output previews after this many lines. |
tool_output.max_bytes | positive integer | Truncate long tool output previews after this many bytes. |
compaction.auto | true, false | Compact automatically when context is full. |
compaction.prune | true, false | Prune old tool outputs during compaction. |
+ compaction.tail_turns | non-negative integer | Number of recent user turns to keep verbatim during compaction (default: 2). |
+ compaction.reserved | non-negative integer | Token buffer to leave free so compaction does not overflow the context window. |