Skip to content

Commit e5d988d

Browse files
committed
deploy: 252c50a
1 parent 09186c3 commit e5d988d

27 files changed

Lines changed: 39 additions & 32 deletions

File tree

CHANGELOG/index.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4187,6 +4187,7 @@ <h2 id="unreleased">Unreleased<a class="headerlink" href="#unreleased" title="Pe
41874187
<ul>
41884188
<li>Improve rules with frontmatter filters, condition variables, path-scoped loading, enforcement support, and clearer documentation. #222</li>
41894189
<li><code>preToolCall</code> hooks now receive <code>approval: "ask"</code> for the native <code>ask_user</code> tool so notification hooks (e.g. matching <code>.approval == "ask"</code>) also fire when the chat is blocked waiting for a user answer, regardless of trust mode.</li>
4190+
<li>New <code>${cmd:some command}</code> dynamic string backend that resolves to the trimmed stdout of a shell command, useful for password managers like <code>pass</code> or <code>op</code>. On macOS the user's interactive shell <code>$PATH</code> is queried once so GUI-launched ECA picks up Homebrew, <code>mise</code>/<code>asdf</code> shims, etc. #430</li>
41904191
</ul>
41914192
<h2 id="01292">0.129.2<a class="headerlink" href="#01292" title="Permanent link">#</a></h2>
41924193
<ul>
@@ -5865,7 +5866,7 @@ <h2 id="001">0.0.1<a class="headerlink" href="#001" title="Permanent link">#</a>
58655866
<span class="md-icon" title="Last update">
58665867
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
58675868
</span>
5868-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:31 UTC">April 27, 2026</span>
5869+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:12:15 UTC">April 27, 2026</span>
58695870
</span>
58705871

58715872

config.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -482,17 +482,17 @@
482482
},
483483
"url": {
484484
"type": "string",
485-
"description": "Base URL for the provider's API. Supports dynamic strings like ${env:VAR}.",
486-
"markdownDescription": "Base URL for the provider's API. Supports dynamic strings like ${env:VAR}.",
485+
"description": "Base URL for the provider's API. Supports dynamic strings like ${env:VAR} or ${cmd:command}.",
486+
"markdownDescription": "Base URL for the provider's API. Supports dynamic strings like `${env:VAR}` or `${cmd:command}`.",
487487
"format": "uri"
488488
},
489489
"key": {
490490
"type": [
491491
"string",
492492
"null"
493493
],
494-
"description": "API key for authentication. Supports dynamic strings like ${env:MY_API_KEY}.",
495-
"markdownDescription": "API key for authentication. Supports dynamic strings like ${env:MY_API_KEY}."
494+
"description": "API key for authentication. Supports dynamic strings like ${env:MY_API_KEY}, ${netrc:host} or ${cmd:pass show eca/api-key}.",
495+
"markdownDescription": "API key for authentication. Supports dynamic strings like `${env:MY_API_KEY}`, `${netrc:host}` or `${cmd:pass show eca/api-key}`."
496496
},
497497
"keyRc": {
498498
"type": "string",

config/agents/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1559,7 +1559,7 @@ <h2 id="subagents">Subagents<a class="headerlink" href="#subagents" title="Perma
15591559
<span class="md-icon" title="Last update">
15601560
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
15611561
</span>
1562-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1562+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
15631563
</span>
15641564

15651565

config/commands/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1323,7 +1323,7 @@ <h1 id="commands">Commands<a class="headerlink" href="#commands" title="Permanen
13231323
<span class="md-icon" title="Last update">
13241324
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
13251325
</span>
1326-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1326+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
13271327
</span>
13281328

13291329

config/completion/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1308,7 +1308,7 @@ <h1 id="completion">Completion<a class="headerlink" href="#completion" title="Pe
13081308
<span class="md-icon" title="Last update">
13091309
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
13101310
</span>
1311-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1311+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
13121312
</span>
13131313

13141314

config/context-management/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1503,7 +1503,7 @@ <h2 id="file-reading">File Reading<a class="headerlink" href="#file-reading" tit
15031503
<span class="md-icon" title="Last update">
15041504
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
15051505
</span>
1506-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1506+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
15071507
</span>
15081508

15091509

config/examples/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1824,7 +1824,7 @@ <h2 id="from-users">From users<a class="headerlink" href="#from-users" title="Pe
18241824
<span class="md-icon" title="Last update">
18251825
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
18261826
</span>
1827-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1827+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
18281828
</span>
18291829

18301830

config/hooks/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1640,7 +1640,7 @@ <h2 id="examples">Examples<a class="headerlink" href="#examples" title="Permanen
16401640
<span class="md-icon" title="Last update">
16411641
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
16421642
</span>
1643-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1643+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
16441644
</span>
16451645

16461646

config/introduction/index.html

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1455,7 +1455,13 @@ <h3 id="dynamic-string-contents">Dynamic string contents<a class="headerlink" hr
14551455
<li><code>env</code>: <code>${env:MY_ENV}</code> to get a system env value with support for default values: <code>${env:MY_ENV:foo}</code></li>
14561456
<li><code>classpath</code>: <code>${classpath:path/to/eca/file}</code> to get a file content from <a href="https://github.com/editor-code-assistant/eca/tree/master/resources">ECA's classpath</a></li>
14571457
<li><code>netrc</code>: Support Unix RC <a href="../models/#credential-file-authentication">credential files</a></li>
1458+
<li><code>cmd</code>: <code>${cmd:some command}</code> to run a command via the platform shell (<code>bash -c</code> on POSIX, PowerShell on Windows) and use its trimmed stdout — useful for password managers like <code>${cmd:pass show eca/api-key}</code> or <code>${cmd:op read op://vault/Item/credential}</code>. On non-zero exit/timeout the value falls back to an empty string and a warning is logged. The command itself cannot contain <code>}</code> (the closing brace ends the placeholder); for commands like <code>awk '{print $1}' …</code>, wrap them in a small script or shell function.</li>
14581459
</ul>
1460+
<div class="admonition info">
1461+
<p class="admonition-title">macOS GUI launches</p>
1462+
<p>When ECA runs from Finder/Dock (e.g. via ECA Desktop) the inherited <code>PATH</code> is minimal and Homebrew, <code>mise</code>/<code>asdf</code> shims, etc. are not visible. To fix this, on macOS the <code>cmd</code> backend spawns the user's interactive login shell once (<code>$SHELL -ilc '…'</code>) and reuses the captured <code>$PATH</code> for subsequent <code>${cmd:...}</code> resolutions — so anything sourced from <code>.zshrc</code>/<code>.zprofile</code>/<code>.bash_profile</code> is picked up automatically. If the shell query fails or your shell isn't bash/zsh/sh/dash/ksh, ECA falls back to prepending <code>/opt/homebrew/bin</code>, <code>/usr/local/bin</code> and <code>~/.local/bin</code>. As a last resort, use an absolute path (e.g. <code>${cmd:/opt/custom/bin/my-tool ...}</code>).</p>
1463+
<p>Linux GUI launches can have a similar (less severe) <code>PATH</code> gap, but shell-<code>PATH</code> discovery is currently macOS-only — Linux users with the same problem should use absolute paths in <code>${cmd:...}</code> for now.</p>
1464+
</div>
14591465
<div class="admonition info markdown support">
14601466
<p class="admonition-title">Info</p>
14611467
<p>This is supported in markdown configurations of agents and skills as well, giving flexibility to template it.</p>
@@ -1563,7 +1569,7 @@ <h2 id="default-config">Default config<a class="headerlink" href="#default-confi
15631569
<span class="md-icon" title="Last update">
15641570
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
15651571
</span>
1566-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1572+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
15671573
</span>
15681574

15691575

config/metrics/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1360,7 +1360,7 @@ <h2 id="opentelemetry-integration">Opentelemetry integration<a class="headerlink
13601360
<span class="md-icon" title="Last update">
13611361
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
13621362
</span>
1363-
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 14:43:11 UTC">April 27, 2026</span>
1363+
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="April 27, 2026 15:11:20 UTC">April 27, 2026</span>
13641364
</span>
13651365

13661366

0 commit comments

Comments
 (0)