Skip to content

armgit / Orkas

Public Imported from GitHub
0

Orkas is an open-source (MIT), local-first AI team for your desktop: a Commander turns your goal into to-dos and coordinates 16 built-in specialist agents plus Claude Code, Codex, OpenCode, OpenClaw and Hermes, with projects, scheduled automations and connectors. Free app for macOS & Windows; built-in models or your own keys.

Use public Orkas name in open-source project

wyt94c0b65393a4
diff --git a/CLAUDE.md b/CLAUDE.md
index 5985e238..217622ce 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -55,7 +55,7 @@ Residual shared prompt rules should have one canonical source, with downstream p
All user-scoped data lives under `<container>/data/<uid>/{cloud,local}/`.
- Top-level data may contain only `users.json`, `logs/`, and user directories.
-- Hosted builds use `anonymous` while logged out and the Server account uid while logged in. OrkasOpen first boot keeps the legacy generated local id.
+- Hosted builds use `anonymous` while logged out and the Server account uid while logged in. The open-source build first boot keeps the legacy generated local id.
- `uid` is an opaque single path segment. Do not parse it or embed it into session ids.
- `cloud/` is syncable user-private state: chats, resumable sessions, attachments, artifacts, saved apps, contexts source files, memory, custom agents/skills, projects, marketplace install manifest, auto tasks, and user config.
- `local/` is machine-private state: account/session cache, marketplace installed content, caches, indexes, vector DB, workspace selection, tool-result spills, local-agent archives, and dev archives.
@@ -64,13 +64,13 @@ All user-scoped data lives under `<container>/data/<uid>/{cloud,local}/`.
- Project membership is an index field on a conversation. Do not encode `project_id` into paths, cids, or session ids.
- Project lists are directory scans; do not restore an aggregate `projects/_index.json`.
-## Account, Sync, And OrkasOpen
+## Account, Sync, And Open-Source Builds
- Hosted account login uses the Server `SessionMgr` pair (`user_id`, `session_id`), stored through `util/local-secret-store.ts`. There is no client refresh-token loop.
- Authenticated HTTP calls carry `user_id` + `session_id`; WebSocket URLs carry the same pair only where required.
- Optimistic login state may come from disk, but network revalidation must refresh or clear it.
- Private hosted secret backends stay behind the local-secret facade. Do not import `features/hosted_secrets/` outside that facade.
-- Account, relay, voice, sync, billing, and marketplace-dev surfaces that depend on hosted Server features are stripped from OrkasOpen according to `OpenSource/SyncCode/strip-rules.json`. Do not add new hosted-only files without updating strip rules.
+- Account, relay, voice, sync, billing, and marketplace-dev surfaces that depend on hosted Server features are stripped from the open-source build according to `OpenSource/SyncCode/strip-rules.json`. Do not add new hosted-only files without updating strip rules.
- PC never writes `private/<oauth_user_id>/manifest.json`; Server `/sync/manifest/commit` is the only writer.
- Cloud sync paths use OAuth `user_id`, not an unrelated local uid.
- Object transfers under the sync prefix go through `features/sync/transport.ts`.
diff --git a/run.cmd b/run.cmd
index 2001d969..2a203c8b 100644
--- a/run.cmd
+++ b/run.cmd
@@ -10,7 +10,7 @@ if not exist "%APP_DIR%\package.json" (
exit /b 1
)
-echo [Orkas] 启动 OrkasOpen (global prod)
+echo [Orkas] 启动 Orkas (global prod)
call node "%APP_DIR%\scripts\ensure-deps.cjs"
if errorlevel 1 exit /b 1
diff --git a/run.sh b/run.sh
index 386a97a7..cb4edbe1 100755
--- a/run.sh
+++ b/run.sh
@@ -5,7 +5,7 @@
# Usage:
# ./run.sh
#
-# OrkasOpen has exactly one server environment: global prod.
+# Orkas source builds use exactly one server environment: global prod.
set -e
APP_DIR="$(cd "$(dirname "$0")" && pwd)"
@@ -37,7 +37,7 @@ EOF
exit 1
fi
-echo "[Orkas] Starting OrkasOpen (global prod)"
+echo "[Orkas] Starting Orkas (global prod)"
node "$APP_DIR/scripts/ensure-deps.cjs"
diff --git a/src/main/features/agents.ts b/src/main/features/agents.ts
index 73a5e307..2426102f 100644
--- a/src/main/features/agents.ts
+++ b/src/main/features/agents.ts
@@ -1337,7 +1337,7 @@ async function _applyAgentUpdates(
}
/** Edit-chat dispatcher: routes to custom write for custom agents. Platform
- * and marketplace agents are read-only in OrkasOpen. */
+ * and marketplace agents are read-only in the open-source build. */
export async function updateAgentSpec(
agentId: string, updates: UpdateAgentFields,
): Promise<Agent | null> {
diff --git a/src/main/features/auth.ts b/src/main/features/auth.ts
index 72937c8c..d31c54c8 100644
--- a/src/main/features/auth.ts
+++ b/src/main/features/auth.ts
@@ -15,7 +15,7 @@
* imageProfiles: [ { id, provider, apiKey, label, createdAt } ] // v4+
* }
* The file body is encrypted through `util/local-secret-store`: Hosted Orkas writes
- * `ORKLSEC1:`, while OrkasOpen falls back to the open-source backend. The read path accepts
+ * `ORKLSEC1:`, while the open-source build falls back to the open backend. The read path accepts
* the previous whole-file `crypto-vault` payload and plaintext JSON as one-shot migration
* inputs, then rewrites with the preferred backend.
*
@@ -260,7 +260,7 @@ function authSecretOwner(localId: string): string {
if (obj && typeof obj === 'object' && typeof obj.user_id === 'string' && obj.user_id) {
return obj.user_id;
}
- } catch { /* logged out / OrkasOpen / unreadable account file */ }
+ } catch { /* logged out / open-source build / unreadable account file */ }
return localId;
}
diff --git a/src/main/features/chats.ts b/src/main/features/chats.ts
index 3bb8bbdf..698cc0bf 100644
--- a/src/main/features/chats.ts
+++ b/src/main/features/chats.ts
@@ -372,7 +372,7 @@ async function _removeConversationMeta(userId: string, cid: string): Promise<voi
}
function _notifyChatIndexDirty(): void {
- // OrkasOpen is local-only; cloud sync notification is intentionally absent.
+ // The open-source build is local-only; cloud sync notification is intentionally absent.
}
function _messageText(raw: any): string {
diff --git a/src/main/features/component_enabled.ts b/src/main/features/component_enabled.ts
index 054f371c..09a667da 100644
--- a/src/main/features/component_enabled.ts
+++ b/src/main/features/component_enabled.ts
@@ -49,7 +49,7 @@ import { createLogger } from '../logger';
const log = createLogger('component-enabled');
function _notifyDirty(): void {
- // OrkasOpen is local-only; cloud sync notification is intentionally absent.
+ // The open-source build is local-only; cloud sync notification is intentionally absent.
}
const SCHEMA_VERSION = 1;
diff --git a/src/main/features/config.ts b/src/main/features/config.ts
index 3caace98..72861e45 100644
--- a/src/main/features/config.ts
+++ b/src/main/features/config.ts
@@ -47,7 +47,7 @@ export interface UserPreferences {
metacognition_enabled?: boolean;
/** Whether machine-global skill roots such as ~/.codex/skills are visible
* to commander open-tier skill search. Missing means enabled, preserving
- * the historical OrkasOpen behavior. */
+ * the historical open-source behavior. */
global_skill_roots_enabled?: boolean;
/** Per-field update clocks used by cloud-sync to merge independent
* preference changes without treating the whole JSON file as one blob. */
diff --git a/src/main/features/connectors/_server_bridge.ts b/src/main/features/connectors/_server_bridge.ts
index 0d91ac63..87e7806e 100644
--- a/src/main/features/connectors/_server_bridge.ts
+++ b/src/main/features/connectors/_server_bridge.ts
@@ -1,16 +1,16 @@
/**
- * Server-bridge stubs for connector OAuth in the OrkasOpen build.
+ * Server-bridge stubs for connector OAuth in the open-source build.
*
* PC's `features/connectors/oauth*.ts` reaches into `features/account/{server,token_store}` for:
* - `accountApiBase()` — the Orkas global prod Server base URL
* - `tokenStore.getDeviceId()` — stable per-machine UUID
* - `tokenStore.authHeaders()` — `{user_id, session_id}` for the logged-in user
*
- * `features/account/` is stripped from OrkasOpen (no account backend). Connectors still need the
+ * `features/account/` is stripped from the open-source build (no account backend). Connectors still need the
* first two pieces because the Server bridges every connector OAuth flow regardless of login
* state (`/connectors/oauth/exchange` accepts a `device_id`-only request, per PC/CLAUDE.md §6.5
- * "OrkasOpen connectors" section). The third piece is always empty here — there is no Orkas
- * session in OrkasOpen — but exposing the same signature keeps the call sites identical.
+ * "open-source connectors" section). The third piece is always empty here because there is no Orkas
+ * session in the open-source build, but exposing the same signature keeps the call sites identical.
*
* Where each piece comes from:
* - `accountApiBase` aliases `features/marketplace.apiBase()` (global prod only — single
@@ -71,7 +71,7 @@ export const tokenStore = {
},
authHeaders(): Record<string, string> {
- // OrkasOpen has no Orkas account session. The Server's `/connectors/oauth/exchange`
+ // The open-source build has no Orkas account session. The Server's `/connectors/oauth/exchange`
// endpoint accepts device_id-only requests for this build (per PC/CLAUDE.md §6.5).
return {};
},
diff --git a/src/main/features/connectors/catalog-google.ts b/src/main/features/connectors/catalog-google.ts
index 1003e129..3bf1d9de 100644
--- a/src/main/features/connectors/catalog-google.ts
+++ b/src/main/features/connectors/catalog-google.ts
@@ -1,6 +1,6 @@
/**
* Google Workspace catalog entries — extracted from `catalog.ts` so the Google bundle and
- * per-service connectors stay isolated while still syncing to OrkasOpen. Both PC and OrkasOpen
+ * per-service connectors stay isolated while still syncing to the open-source build. Both hosted and open-source
* include this file via a try/require in `catalog.ts`; the catch path only keeps older open-source
* checkouts without this file from crashing.
*
diff --git a/src/main/features/connectors/catalog.ts b/src/main/features/connectors/catalog.ts
index e2750f2b..06b21852 100644
--- a/src/main/features/connectors/catalog.ts
+++ b/src/main/features/connectors/catalog.ts
@@ -72,15 +72,15 @@ export const CONNECTOR_CATALOG: CatalogEntry[] = [
},
},
// Google Workspace entries (`google-workspace` bundle + 5 service members) live in
- // `catalog-google.ts` and are loaded via `_loadGoogleEntries` below. PC and OrkasOpen both
- // ship them; the try/require keeps older OrkasOpen checkouts that lack the file from crashing.
+ // `catalog-google.ts` and are loaded via `_loadGoogleEntries` below. Hosted and open-source
+ // builds both ship them; the try/require keeps older open-source checkouts that lack the file from crashing.
..._loadGoogleEntries(),
];
function _loadGoogleEntries(): CatalogEntry[] {
try {
// `require` (not `import`) so the path isn't statically resolved at bundle time. Older
- // OrkasOpen builds may lack this file; swallow and return [] for that compatibility case.
+ // Older open-source builds may lack this file; swallow and return [] for that compatibility case.
// eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
const mod = require('./catalog-google') as { GOOGLE_ENTRIES?: CatalogEntry[] };
return Array.isArray(mod.GOOGLE_ENTRIES) ? mod.GOOGLE_ENTRIES : [];
diff --git a/src/main/features/connectors/registry.ts b/src/main/features/connectors/registry.ts
index 0eaa0256..2257c463 100644
--- a/src/main/features/connectors/registry.ts
+++ b/src/main/features/connectors/registry.ts
@@ -17,14 +17,14 @@
*
* **Secret owner = Orkas-account OAuth user_id (when logged in), else local uid**. Same OAuth
* user_id on every device the user signs into → cross-device decryption after cloud sync.
- * OrkasOpen / not-logged-in falls back to local uid (file then sits in cloud/config/ but the
+ * Open-source / not-logged-in falls back to local uid (file then sits in cloud/config/ but the
* sync engine is inactive without an account, so it stays machine-private de facto). See
* `_secretOwner` for the resolution.
*
* Sync trigger: each write fires `syncFeature.markDirty('connectors', 'cloud/config/connectors.json')`
* so user actions (install / disconnect / refresh) push within the debounce window rather than
* waiting for the 5-min periodic. Like sync itself, gracefully no-ops in builds that strip
- * `features/sync` (OrkasOpen).
+ * `features/sync` (open-source build).
*
* All writes are serialized via async-mutex so two concurrent IPC calls can't race-overwrite.
*/
@@ -62,7 +62,7 @@ interface SecretsBlob { oauth_grant?: OAuthGrant; dcr_client?: DcrClientCredenti
const PRESERVED_SECRETS = Symbol('preservedConnectorSecrets');
type ConnectorInstanceWithPreservedSecrets = ConnectorInstance & { [PRESERVED_SECRETS]?: string };
-// Secret-owner resolver. OrkasOpen stores connector secrets under the local uid.
+// Secret-owner resolver. The open-source build stores connector secrets under the local uid.
function _secretOwner(uid: string): string {
return uid;
}
@@ -76,7 +76,7 @@ function _secretContext(uid: string, instanceId: string): localSecrets.LocalSecr
}
function _notifyDirty(): void {
- // OrkasOpen is local-only; cloud sync notification is intentionally absent.
+ // The open-source build is local-only; cloud sync notification is intentionally absent.
}
function _notifyRendererChanged(): void {
@@ -84,7 +84,7 @@ function _notifyRendererChanged(): void {
// eslint-disable-next-line @typescript-eslint/no-require-imports, global-require
const ipc = require('../../ipc') as { broadcastToRenderer?: (channel: string, payload: unknown) => void };
ipc.broadcastToRenderer?.('connectors:changed', { changed: true });
- } catch { /* tests / OrkasOpen may not have the IPC bridge loaded */ }
+ } catch { /* tests / open-source build may not have the IPC bridge loaded */ }
}
function _notifyChanged(): void {
diff --git a/src/main/features/group_chat/bus.ts b/src/main/features/group_chat/bus.ts
index 23ef6164..67bc817b 100644
--- a/src/main/features/group_chat/bus.ts
+++ b/src/main/features/group_chat/bus.ts
@@ -1585,7 +1585,7 @@ async function runTurn(state: CidState, w: WorkerState, item: QueueItem): Promis
if (turnSyncConflictResolution.length && workingText && !errText && !aborted) {
const results = extractSyncConflictResults(workingText);
if (results.length) {
- log.warn(`sync conflict result ignored in OrkasOpen cid=${cid}: sync feature is stripped`);
+ log.warn(`sync conflict result ignored in open-source build cid=${cid}: sync feature is stripped`);
}
}
@@ -1639,7 +1639,7 @@ async function runTurn(state: CidState, w: WorkerState, item: QueueItem): Promis
} else if (agentsFeat.isCliAgent(target)) {
workingText = `${workingText}\n\n<span style="color:var(--danger)">⚠️ External agents can only be edited from the right-hand detail panel.</span>`;
} else {
- // `updateAgentSpec` dispatches only custom agents in OrkasOpen.
+ // `updateAgentSpec` dispatches only custom agents in the open-source build.
const updated = await agentsFeat.updateAgentSpec(editId, fields);
if (updated) {
createdAgents.push({ agent_id: updated.agent_id, name: updated.name, kind: 'updated' });
diff --git a/src/main/features/local_agents/bridge_permissions.ts b/src/main/features/local_agents/bridge_permissions.ts
index 3d43e1ef..564f8236 100644
--- a/src/main/features/local_agents/bridge_permissions.ts
+++ b/src/main/features/local_agents/bridge_permissions.ts
@@ -99,7 +99,7 @@ const _pending = new Map<string, Pending>();
/** Lazy ipc lookup — same pattern `connectors/registry.ts` uses for
* `connectors:changed`; avoids a static feature→ipc import cycle and
- * degrades cleanly in tests / OrkasOpen builds without the IPC bridge. */
+ * degrades cleanly in tests / open-source builds without the IPC bridge. */
function _broadcast(channel: string, payload: unknown): boolean {
if (_broadcastOverride) {
_broadcastOverride(channel, payload);
diff --git a/src/main/features/marketplace.ts b/src/main/features/marketplace.ts
index 58d8e43a..dd18ad85 100644
--- a/src/main/features/marketplace.ts
+++ b/src/main/features/marketplace.ts
@@ -76,7 +76,7 @@ import { persistReport as persistQualityReport } from '../quality/report';
const log = createLogger('marketplace');
// ── server URL ────────────────────────────────────────────────────────────
-// OrkasOpen has exactly one server environment: global prod. Use the apex host directly
+// The open-source build has exactly one server environment: global prod. Use the apex host directly
// so POST marketplace calls do not first hit a www -> apex 301 redirect.
const GLOBAL_PROD_API_BASE = 'https://orkas.ai' + '/api';
diff --git a/src/main/features/marketplace_installs.ts b/src/main/features/marketplace_installs.ts
index 68e6b27c..4697a815 100644
--- a/src/main/features/marketplace_installs.ts
+++ b/src/main/features/marketplace_installs.ts
@@ -54,7 +54,7 @@ import { isExpiredMsTombstone } from '../util/tombstone_retention';
const log = createLogger('marketplace_installs');
function _markInstallsDirty(): void {
- // OrkasOpen is local-only; cloud sync notification is intentionally absent.
+ // The open-source build is local-only; cloud sync notification is intentionally absent.
}
// Per-uid mutex covering the RMW cycle of add*/remove* (read manifest → mutate → write).
diff --git a/src/main/features/projects.ts b/src/main/features/projects.ts
index a3695ea6..0bda098f 100644
--- a/src/main/features/projects.ts
+++ b/src/main/features/projects.ts
@@ -199,7 +199,7 @@ async function _writeBindings(uid: string, pid: string, b: ProjectBindings): Pro
}
function _notifyDirty(): void {
- // OrkasOpen is local-only; cloud sync notification is intentionally absent.
+ // The open-source build is local-only; cloud sync notification is intentionally absent.
}
// ── Validation ────────────────────────────────────────────────────────────
diff --git a/src/main/features/skills.ts b/src/main/features/skills.ts
index 40a6fbb2..bd19826f 100644
--- a/src/main/features/skills.ts
+++ b/src/main/features/skills.ts
@@ -1814,7 +1814,7 @@ export function _writeSkillFileAt(
}
/** Edit-chat dispatcher (with validation report). Routes to custom write for
- * custom ids. Platform and marketplace skills are read-only in OrkasOpen. */
+ * custom ids. Platform and marketplace skills are read-only in the open-source build. */
export async function writeSkillFileForEditChecked(
skillId: string,
relpath: string,
diff --git a/src/main/features/users.ts b/src/main/features/users.ts
index 1bdab25b..0901eedf 100644
--- a/src/main/features/users.ts
+++ b/src/main/features/users.ts
@@ -11,7 +11,7 @@
* - `anonymous` while logged out.
* - the server account uid while logged in.
*
- * OrkasOpen still calls `initActiveUser()` without options, so first boot
+ * The open-source build still calls `initActiveUser()` without options, so first boot
* keeps the original 8-digit local id.
*
* Boot sequence:
@@ -64,7 +64,7 @@ interface UsersRegistry {
}
export interface InitActiveUserOptions {
- /** Hosted Orkas passes `anonymous`; OrkasOpen omits this and gets a generated 8-digit uid. */
+ /** Hosted Orkas passes `anonymous`; the open-source build omits this and gets a generated 8-digit uid. */
defaultLocalId?: string;
}
@@ -90,7 +90,7 @@ let CURRENT_USER_FIELD: CurrentUserField = 'current_user_id';
/**
* Select which persisted pointer this process owns. `index.ts` calls this
- * once during boot before any registry reads. Tests and OrkasOpen can omit it
+ * once during boot before any registry reads. Tests and the open-source build can omit it
* and keep the historical `current_user_id` behavior.
*/
export function setUseDevCurrentUserId(useDev: boolean): void {
@@ -365,7 +365,7 @@ export function activateUser(uid: string): void {
/**
* Boot-time entrypoint — read users.json and activate this environment's
* current-user pointer. If none exists, activate `defaultLocalId` (hosted:
- * anonymous) or generate the legacy 8-digit uid (OrkasOpen).
+ * anonymous) or generate the legacy 8-digit uid (open-source build).
*/
export function initActiveUser(opts: InitActiveUserOptions = {}): UserRecord {
const reg = readRegistry();
diff --git a/src/main/index.ts b/src/main/index.ts
index c518cc93..855db553 100644
--- a/src/main/index.ts
+++ b/src/main/index.ts
@@ -42,7 +42,7 @@ import './install-data-root.cjs';
const APP_USER_MODEL_ID = 'com.orkas.desktop';
-// OrkasOpen source and packaged builds share one app identity and one server
+// Source and packaged builds share one app identity and one server
// environment: global prod. This keeps local data paths and OS app grouping
// stable across run modes.
app.setName('Orkas');
@@ -147,7 +147,7 @@ import * as clientConfigFeature from './features/client_config';
import * as connectorsFeature from './features/connectors';
import * as windowState from './features/window_state';
// Server-backed account, multi-device sync, remote-control relay, and
-// auto-update features are stripped in OrkasOpen. Connectors remain available
+// auto-update features are stripped in the open-source build. Connectors remain available
// through the open server bridge.
function createWindow(): BrowserWindow {
@@ -768,7 +768,7 @@ if (!gotLock) {
registerKbFileProtocol();
registerChatMediaProtocol();
registerChatAppProtocol();
- // Renderer permission gate. Voice input is stripped from OrkasOpen, so media
+ // Renderer permission gate. Voice input is stripped from the open-source build, so media
// capture is denied; clipboard permissions are kept for copy/paste flows.
session.defaultSession.setPermissionRequestHandler((_wc, permission, callback) => {
callback(permission === 'clipboard-read' || permission === 'clipboard-sanitized-write');
diff --git a/src/main/ipc/index.ts b/src/main/ipc/index.ts
index 9052f4b7..1bceffb3 100644
--- a/src/main/ipc/index.ts
+++ b/src/main/ipc/index.ts
@@ -2051,7 +2051,7 @@ const invokeHandlers: Record<string, InvokeHandler> = {
return { ok: true, path: target };
},
- // Internal debug panel data is stripped from OrkasOpen. Keep stable
+ // Internal debug panel data is stripped from the open-source build. Keep stable
// handler shapes so stale renderer calls receive empty results.
'devtools.listArchives': async () => ({ items: [] }),
'devtools.readArchive': async () => ({ item: null }),
@@ -2063,17 +2063,17 @@ const invokeHandlers: Record<string, InvokeHandler> = {
return aggregateSkillMetrics({ sinceDays: Number.isFinite(sinceDays) ? Number(sinceDays) : undefined });
},
- // User-account login (Google OAuth). Stripped from the OrkasOpen build.
+ // User-account login (Google OAuth). Stripped from the open-source build.
// User feedback from Settings. Depends on the account session for Server auth.
- // Multi-device sync. Stripped from the OrkasOpen build (depends on account).
+ // Multi-device sync. Stripped from the open-source build (depends on account).
// Quality validator — renderer reads persisted ValidationReports to display
// why a spec write / marketplace install was rejected.
...qualityHandlers,
// Connectors (MCP-based). User-installed MCP servers expose tools to commander + selected
- // agents. No Server dependency → kept in OrkasOpen.
+ // agents. No Server dependency, so kept in the open-source build.
...connectorsHandlers,
// Cross-session memory UI — view/edit/import/export over features/memory.ts.
diff --git a/src/main/model/core-agent/client.ts b/src/main/model/core-agent/client.ts
index 5cb016ac..60ca446c 100644
--- a/src/main/model/core-agent/client.ts
+++ b/src/main/model/core-agent/client.ts
@@ -283,7 +283,7 @@ export async function* streamChatWithModel(opts: ChatOptions): AsyncGenerator<St
try {
// Called back when pi-ai's onPayload hook injects the native web
- // search tool. The OrkasOpen recorder is a non-null no-op object.
+ // search tool. The open-source recorder is a non-null no-op object.
const built = await buildRunner({
sessionId,
systemPrompt,
diff --git a/src/main/model/core-agent/fetch-diag.ts b/src/main/model/core-agent/fetch-diag.ts
index b36624ee..0775a664 100644
--- a/src/main/model/core-agent/fetch-diag.ts
+++ b/src/main/model/core-agent/fetch-diag.ts
@@ -13,7 +13,7 @@
* no actionable signal.
*
* When it runs:
- * - OrkasOpen installs it unconditionally so provider fetch failures surface
+ * - The open-source build installs it unconditionally so provider fetch failures surface
* their real cause in both development and packaged builds.
*
* Scope:
diff --git a/src/main/model/provider_policy.ts b/src/main/model/provider_policy.ts
index e4cc4a82..59fff413 100644
--- a/src/main/model/provider_policy.ts
+++ b/src/main/model/provider_policy.ts
@@ -3,7 +3,7 @@ import { isDeepSeekModelConfigEnabled } from '../features/client_config';
/**
* DeepSeek availability is controlled by Server client config
* `model.deepseek.enabled`. The desktop default is enabled so offline and
- * OrkasOpen runs keep the provider available until Server says otherwise.
+ * Open-source runs keep the provider available until Server says otherwise.
*/
export function isDeepSeekIntegrationEnabled(): boolean {
return isDeepSeekModelConfigEnabled();
diff --git a/src/main/paths.ts b/src/main/paths.ts
index 46ea23b4..cff3b020 100644
--- a/src/main/paths.ts
+++ b/src/main/paths.ts
@@ -251,7 +251,7 @@ export const autoTaskAttachmentsDir = (uid: string, taskId: string) => path.join
// (local-secret encrypted with the active Orkas account's OAuth user_id as owner — see
// `features/connectors/registry.ts`). Cloud-synced as of 2026-05-15 so a user authorizing on
// one device sees the same connectors on another. **Secret owner:** OAuth user_id (not local uid)
-// so any device logged into the same Orkas account can decrypt; OrkasOpen / not-logged-in
+// so any device logged into the same Orkas account can decrypt; open-source / not-logged-in
// users fall back to local uid (the file then sits in cloud/config/ but doesn't actually
// sync — sync engine is inactive without an account).
export const userConnectorsConfigFile = (uid: string) => path.join(userCloudConfigDir(uid), 'connectors.json');
diff --git a/src/main/util/crypto-vault.ts b/src/main/util/crypto-vault.ts
index 8d5335cf..f758a6bd 100644
--- a/src/main/util/crypto-vault.ts
+++ b/src/main/util/crypto-vault.ts
@@ -19,7 +19,7 @@
* - Targeted forensic recovery from a stolen device.
*
* Hosted Orkas should normally go through `util/local-secret-store.ts`, which uses the private
- * `ORKLSEC1:` backend when available and calls this module only as an OrkasOpen fallback or for
+ * `ORKLSEC1:` backend when available and calls this module only as an open-source fallback or for
* one-shot migration of older files.
*
* File layout written to disk:
diff --git a/src/main/util/device.ts b/src/main/util/device.ts
index a8c0af8d..82275339 100644
--- a/src/main/util/device.ts
+++ b/src/main/util/device.ts
@@ -8,7 +8,7 @@
*
* Why not reuse `features/account/token_store.ts::getDeviceId`?
* - That returns a random UUID, not the MAC the user asked for.
- * - The whole `features/account/` module is stripped from OrkasOpen
+ * - The whole `features/account/` module is stripped from the open-source build
* builds; auto-tasks must work offline-first.
*
* Stable for the process lifetime — cached on first read. Network adapter
diff --git a/src/main/util/local-secret-store.ts b/src/main/util/local-secret-store.ts
index 90a86409..33b63017 100644
--- a/src/main/util/local-secret-store.ts
+++ b/src/main/util/local-secret-store.ts
@@ -2,7 +2,7 @@
* Shared facade for local secret persistence.
*
* Hosted Orkas uses the private backend in `features/hosted_secrets/` and writes
- * `ORKLSEC1:` payloads. OrkasOpen does not ship that backend; the same facade
+ * `ORKLSEC1:` payloads. The open-source build does not ship that backend; the same facade
* then falls back to the open-source `crypto-vault` implementation. Callers
* pass explicit context so secrets are bound to their business owner/record.
*/
@@ -36,7 +36,7 @@ function contextSeed(ctx: LocalSecretContext): string {
function hostedBackend(): any | null {
try {
- // Dynamic require by design: OrkasOpen strips this directory, while Hosted Orkas keeps it.
+ // Dynamic require by design: the open-source build strips this directory, while Hosted Orkas keeps it.
// Keep the specifier computed so the OSS orphan-import checker does not treat this optional
// backend as a hard dependency after the private directory is removed.
const spec = ['..', 'features', 'hosted_secrets', 'local_secret_store'].join('/');
diff --git a/src/main/util/migrate-connectors-to-cloud.ts b/src/main/util/migrate-connectors-to-cloud.ts
index 5d8aef7c..2dd25067 100644
--- a/src/main/util/migrate-connectors-to-cloud.ts
+++ b/src/main/util/migrate-connectors-to-cloud.ts
@@ -2,7 +2,7 @@
* One-shot migration: relocate the connectors registry from `<uid>/local/config/connectors.json`
* to `<uid>/cloud/config/connectors.json`.
*
- * Historical PC-only migration. OrkasOpen has no account-backed connector
+ * Historical PC-only migration. The open-source build has no account-backed connector
* sync, so this function always defers and leaves existing local connector
* files in place.
*
diff --git a/src/main/util/migrate-source-data-root.cjs b/src/main/util/migrate-source-data-root.cjs
index 436da285..8c45cd15 100644
--- a/src/main/util/migrate-source-data-root.cjs
+++ b/src/main/util/migrate-source-data-root.cjs
@@ -4,7 +4,7 @@
* (`<container>/data` + `<container>/userWorkSpace`).
*
* Before the data-root unification, source-run (`./run.sh`) wrote into
- * `OpenSource/OrkasOpen/data/`, while packaged builds wrote into
+ * the old source-tree `data/`, while packaged builds wrote into
* `~/.orkas/data/`. This migration runs once at boot to fold the
* source-run tree into the container, so dev and packaged share data
* going forward.
@@ -38,7 +38,7 @@ const path = require('node:path');
const STAMP_FILENAME = '.migrated-from-source';
function migrateSourceDataRoot(targetContainer, repoRootOverride) {
- // __dirname = OrkasOpen/src/main/util → up three for OrkasOpen/.
+ // __dirname = <repo>/src/main/util → up three for the repo root.
const repoRoot = repoRootOverride || path.resolve(__dirname, '..', '..', '..');
const srcData = path.join(repoRoot, 'data');
const srcWs = path.join(repoRoot, 'userWorkSpace');
diff --git a/src/renderer/modules/agents.js b/src/renderer/modules/agents.js
index 9bc908bf..7eab2ee9 100644
--- a/src/renderer/modules/agents.js
+++ b/src/renderer/modules/agents.js
@@ -619,10 +619,10 @@ function _renderAgentRowMenuItems(menu, agentId, source = '') {
if (canEdit) {
items.push(`<div class="agent-row-menu-item" data-action="edit">${escapeHtml(t('agents.edit') + editLabelSuffix)}</div>`);
}
- // Upload-to-marketplace is owned by marketplace_dev.js (renderer-side dev module). OrkasOpen
+ // Upload-to-marketplace is owned by marketplace_dev.js (renderer-side dev module). The open-source build
// doesn't ship that file, so `typeof openMarketplaceUpload === 'function'` is false there
// and the menu item simply doesn't appear — no isDevMode check needed (and would be banned
- // by OrkasOpen's strip-rules anyway).
+ // by the open-source strip-rules anyway).
if (typeof openMarketplaceUpload === 'function') {
items.push(`<div class="agent-row-menu-item" data-action="upload-marketplace">${escapeHtml(t('marketplace.upload'))}</div>`);
}
@@ -771,7 +771,7 @@ function _renderAgentDetail(agent, editing) {
useBtn.setAttribute('aria-disabled', agent.enabled === false ? 'true' : 'false');
}
if (enableBtn) enableBtn.style.display = editing ? 'none' : '';
- // Upload button visibility: gated by marketplace_dev.js's presence (OrkasOpen lacks it).
+ // Upload button visibility: gated by marketplace_dev.js's presence (the open-source build lacks it).
if (uploadBtn) uploadBtn.style.display = (typeof openMarketplaceUpload === 'function' && !editing) ? '' : 'none';
if (delBtn) delBtn.style.display = (canEdit && !editing) ? '' : 'none';
if (editBtn) {
diff --git a/src/renderer/modules/marketplace.js b/src/renderer/modules/marketplace.js
index 606be67d..c175792b 100644
--- a/src/renderer/modules/marketplace.js
+++ b/src/renderer/modules/marketplace.js
@@ -558,7 +558,7 @@ function _mpBindPanel(panel) {
panel.querySelector('[data-mp-search-clear]')?.addEventListener('click', _mpClearSearch);
panel.querySelector('[data-mp-detail-install]')?.addEventListener('click', _mpInstallFromDetail);
// Dev-only delete button click handler is bound by marketplace_dev.js (file absent in
- // OrkasOpen). HTML element ships in index.html with display:none — dev module flips it
+ // the open-source build). HTML element ships in index.html with display:none — dev module flips it
// on via the `onMarketplaceDetailRendered` hook (see below).
}
@@ -1394,7 +1394,7 @@ function _mpRenderDetail() {
}
// Dev-only delete button is rendered + revealed by marketplace_dev.js via the
- // `onMarketplaceDetailRendered` hook below. OrkasOpen has no such file — hook is undefined
+ // `onMarketplaceDetailRendered` hook below. The open-source build has no such file, so the hook is undefined
// and the button stays hidden (display:none from HTML).
if (typeof onMarketplaceDetailRendered === 'function') {
onMarketplaceDetailRendered({ kind, item });
@@ -1778,9 +1778,9 @@ async function mountMarketplaceCategorySelect(elId, initialValue = '') {
}
// Dev-only `openMarketplaceUpload` + `_mpShowUploadWithCategoryDialog` live in
-// `marketplace_dev.js` (physically excluded from OrkasOpen via SyncCode strip-rules).
+// `marketplace_dev.js` (physically excluded from the open-source build via SyncCode strip-rules).
// Callers (agents.js / skills.js per-row menu) check `typeof openMarketplaceUpload === 'function'`
-// to decide whether to show the upload entry — OrkasOpen has no marketplace_dev.js loaded,
+// to decide whether to show the upload entry — the open-source build has no marketplace_dev.js loaded,
// so the menu items just don't appear.
window.addEventListener('i18n-change', _mpOnI18n);
window.addEventListener('oss-catalog-updated', (e) => {
diff --git a/src/renderer/modules/settings.js b/src/renderer/modules/settings.js
index 6d9eecf9..8786bcd2 100644
--- a/src/renderer/modules/settings.js
+++ b/src/renderer/modules/settings.js
@@ -87,7 +87,7 @@ async function loadSettings() {
await _settingsSafeCall('settings metacognition render', _settingsRenderMetacognition);
await _settingsSafeCall('settings data root render', _settingsRenderDataRoot);
// Account card + subscription card (views/login/account_settings.js — absent in
- // OrkasOpen, so these are no-ops there). renderSubscriptionSettings rebinds the
+ // the open-source build, so these are no-ops there). renderSubscriptionSettings rebinds the
// action button's click handler with the current subscription state on every
// render — opening the panel is the canonical "guarantee fresh button binding"
// moment, so call it explicitly here (not just from the account.onChange listener
diff --git a/src/renderer/modules/settings_tabs.js b/src/renderer/modules/settings_tabs.js
index 19e7b942..14d455ca 100644
--- a/src/renderer/modules/settings_tabs.js
+++ b/src/renderer/modules/settings_tabs.js
@@ -1,8 +1,8 @@
// Settings tab switching.
//
-// Lifted out of `sync_settings.js` (stripped from the OrkasOpen build) so the
+// Lifted out of `sync_settings.js` (stripped from the open-source build) so the
// 4-tab restructure still binds. Sync-card init is gone here on purpose —
-// OrkasOpen has no cloud sync, so the 数据 tab only shows the 本地 section.
+// The open-source build has no cloud sync, so the 数据 tab only shows the 本地 section.
//
// Settings.js calls `initSettingsTabs()` under a `typeof === 'function'` guard,
// which is what made the old "tabs unclickable" bug silent.
diff --git a/src/renderer/modules/skills.js b/src/renderer/modules/skills.js
index 425526c7..da303098 100644
--- a/src/renderer/modules/skills.js
+++ b/src/renderer/modules/skills.js
@@ -1066,7 +1066,7 @@ function _openSkillRowMenu(anchorBtn, id, source) {
items.push(
`<div class="skill-row-menu-item" data-action="toggle-enabled">${escapeHtml(enabled ? t('component.disable') : t('component.enable'))}</div>`,
);
- // Upload-to-marketplace owned by marketplace_dev.js (absent in OrkasOpen). typeof check
+ // Upload-to-marketplace owned by marketplace_dev.js (absent in the open-source build). typeof check
// naturally hides the entry on builds that don't ship the dev module.
if (!isOpenTier && typeof openMarketplaceUpload === 'function') {
items.push(
@@ -1354,7 +1354,7 @@ async function selectSkillFile(source, id, filepath, nodeEl) {
}
if (editBtn) editBtn.style.display = canEditThisSkill ? '' : 'none';
if (enableBtn) enableBtn.style.display = editingThis ? 'none' : '';
- // Upload button visibility: gated by marketplace_dev.js's presence (OrkasOpen lacks it).
+ // Upload button visibility: gated by marketplace_dev.js's presence (the open-source build lacks it).
if (uploadBtn) uploadBtn.style.display = (typeof openMarketplaceUpload === 'function' && !editingThis) ? '' : 'none';
if (delBtn) delBtn.style.display = (canEditThisSkill && !editingThis) ? '' : 'none';
}
diff --git a/test/renderer/settings-open.test.ts b/test/renderer/settings-open.test.ts
index c95ce7f1..954eb91f 100644
--- a/test/renderer/settings-open.test.ts
+++ b/test/renderer/settings-open.test.ts
@@ -36,7 +36,7 @@ function count(raw: string, needle: string) {
return raw.split(needle).length - 1;
}
-describe('OrkasOpen Settings sync guards', () => {
+describe('open-source Settings sync guards', () => {
it('loads the standalone settings tabs module before settings.js', () => {
const tabsScript = '<script src="./modules/settings_tabs.js"></script>';
const settingsScript = '<script src="./modules/settings.js"></script>';
@@ -50,7 +50,7 @@ describe('OrkasOpen Settings sync guards', () => {
expect(indexHtml).toMatch(/class=["'][^"']*\bsettings-tab\b[^"']*\bis-active\b[^"']*["'][^>]*data-settings-tab=["']data["']/);
});
- it('keeps unsupported search and image provider controls hidden from OrkasOpen', () => {
+ it('keeps unsupported search and image provider controls hidden from Orkas', () => {
for (const controlId of ['settings-search-provider', 'settings-image-provider']) {
const groupTag = previousSettingsGroupTag(controlId);
expect(groupTag).toMatch(/\bhidden\b/);