ZaguanAI/zblade.dev
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(website): add Local AI setup guide and chat modes docs

Browse Source 
Restructure getting started to cover Local AI and Cloud AI options
with Hybrid support. Add Chat Modes section documenting Code Mode,
Planning Mode, and Implement Action. Expand Settings with Local AI
tab, Configuration, and Experiments details. Update tools page and
add changelog entry for File Explorer drag-to-move fix.
This commit is contained in:
Stig-Ørjan Smelror
2026-05-10 21:34:56 +02:00
parent 154378e067
commit af3c3b1d45
3 changed files with 153 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/pages/tools.astro
+35 -8
View File
@@ -38,6 +38,9 @@ import BaseLayout from '../layouts/BaseLayout.astro';
<a href="#directory-search" class="nav-chip">Directory & Search</a>
<a href="#editor-interaction" class="nav-chip">Editor Interaction</a>
<a href="#command-execution" class="nav-chip">Command Execution</a>
<a href="#code-intelligence" class="nav-chip">Code Intelligence</a>
<a href="#project-index" class="nav-chip">Project Index</a>
<a href="#composite-tools" class="nav-chip">Composite Tools</a>
<a href="#tool-result-handling" class="nav-chip">Result Handling</a>
<a href="#path-resolution" class="nav-chip">Path Resolution</a>
<a href="#system-prompt-integration" class="nav-chip">System Prompt</a>
@@ -791,29 +794,53 @@ import BaseLayout from '../layouts/BaseLayout.astro';
<span class="tool-name">run_command</span>
<span class="tool-tag">TERMINAL</span>
</div>
<p class="tool-desc">Execute a shell command (requires user approval).</p>
<p class="tool-desc">Execute a command in the workspace (requires user approval). Supports both legacy shell-line and structured program+args modes.</p>
</div>
<div class="tool-body">
<div class="tool-params">
<h4>Parameters</h4>
<h4>Structured Mode (preferred)</h4>
<table class="params-table">
<thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead>
<tbody>
<tr><td><code>command</code></td><td><span class="type-badge req">required</span> string</td><td>Shell command to execute</td></tr>
<tr><td><code>cwd</code></td><td><span class="type-badge req">required</span> string</td><td>Working directory</td></tr>
<tr><td><code>program</code></td><td><span class="type-badge req">required*</span> string</td><td>Executable path/name</td></tr>
<tr><td><code>args</code></td><td><span class="type-badge opt">optional</span> array</td><td>Structured arguments list</td></tr>
<tr><td><code>shell</code></td><td><span class="type-badge opt">optional</span> boolean</td><td>Force shell execution (default: false in structured mode)</td></tr>
<tr><td><code>cwd</code></td><td><span class="type-badge opt">optional</span> string</td><td>Working directory</td></tr>
</tbody>
</table>
</div>
<div class="tool-example">
<h4>Example</h4>
<pre is:raw><code>{
<div class="tool-params">
<h4>Legacy Shell Mode</h4>
<table class="params-table">
<thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead>
<tbody>
<tr><td><code>command</code></td><td><span class="type-badge req">required*</span> string</td><td>Shell command line to execute</td></tr>
<tr><td><code>cwd</code></td><td><span class="type-badge opt">optional</span> string</td><td>Working directory</td></tr>
<tr><td><code>blocking</code></td><td><span class="type-badge opt">optional</span> boolean</td><td>Wait for completion (default: true)</td></tr>
<tr><td><code>wait_ms_before_async</code></td><td><span class="type-badge opt">optional</span> integer</td><td>Startup wait when non-blocking</td></tr>
</tbody>
</table>
</div>
<div class="tool-examples-row">
<div class="tool-example">
<h4>Structured (preferred)</h4>
<pre is:raw><code>{
"program": "cargo",
"args": ["build", "--release"],
"cwd": "."
}</code></pre>
</div>
<div class="tool-example">
<h4>Legacy Shell</h4>
<pre is:raw><code>{
"command": "cargo build --release",
"cwd": "."
}</code></pre>
</div>
</div>
<div class="tool-note tool-note-warning">
<span class="note-icon">⚠️</span>
<p class="note-text">This tool requires user confirmation before execution for safety.</p>
<p class="note-text">This tool requires user confirmation before execution. Provide either <code>command</code> or <code>program</code>, not both.</p>
</div>
</div>
</div>