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.

Clarify Windows shell syntax for bash tool

wyt32300e1b4a23
diff --git a/src/main/model/core-agent/local-tools.ts b/src/main/model/core-agent/local-tools.ts
index 6449646c..b7ea4ba1 100644
--- a/src/main/model/core-agent/local-tools.ts
+++ b/src/main/model/core-agent/local-tools.ts
@@ -709,6 +709,12 @@ function guardDisabledSkillBash(opts: LocalToolsOpts, command: string): string |
/** Wrapped `bash` tool — identical schema, permission-gated, host-shell wording. */
function createBashTool(opts: LocalToolsOpts): AgentTool {
+ const windowsShellDescription = process.platform === 'win32'
+ ? 'On Windows, commands run through PowerShell by default: use `$env:NAME` for ' +
+ 'environment variables and avoid POSIX-only syntax such as `&&`, heredocs, ' +
+ '`source`/`export`, and `/dev/null` unless Git Bash is explicitly available. '
+ : '';
+
return {
name: 'bash',
description:
@@ -719,6 +725,7 @@ function createBashTool(opts: LocalToolsOpts): AgentTool {
'should be shown to the user as produced-file chips (for example .docx, .xlsx, ' +
'.pptx, .pdf, images, HTML, CSV, Markdown), write them under the absolute ' +
'$ORKAS_OUTPUT_DIR path, which is the current conversation workspace. ' +
+ windowsShellDescription +
'Scratch/cache files should stay in temporary or cache directories. ' +
'For GUI apps, browsers, servers, watchers, or any command you would normally ' +
'background with `&`, set run_in_background=true instead of shell-backgrounding it; ' +