deploy: 37e8eef933

2026-06-05 21:02:51 +00:00 · 2026-06-05 16:14:37 +00:00
parent 681a0c0de9
commit dee41b2312
1 changed files with 281 additions and 0 deletions
--- a/options.xhtml
+++ b/options.xhtml
@@ -74863,6 +74863,287 @@ attribute set of section of an INI file (attrs of INI atom (null, bool, int, flo
 </td></tr>
 </table>
 </dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.enable"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.enable"><code class="option">programs.pi-coding-agent.enable</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>Whether to enable pi-coding-agent.</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+boolean</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">false
+</code></pre>
+
+<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting nix">true
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.package"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.package"><code class="option">programs.pi-coding-agent.package</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>The pi-coding-agent package to use.</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+null or package</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">pkgs.pi-coding-agent
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.configDir"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.configDir"><code class="option">programs.pi-coding-agent.configDir</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>Directory holding Pi Coding Agent’s configuration files.</p><p>Defaults to <code class="filename">~/.pi/agent</code>, matching the upstream
+<span class="command"><strong>pi</strong></span> CLI default. The <code class="envar">PI_CODING_AGENT_DIR</code>
+environment variable is exported automatically whenever the
+directory differs from this default so the CLI reads
+configuration from the same location.</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+string</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">&quot;${config.home.homeDirectory}/.pi/agent&quot;
+</code></pre>
+
+<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting nix">&quot;${config.xdg.configHome}/pi/agent&quot;
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.context"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.context"><code class="option">programs.pi-coding-agent.context</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>Global context for Pi Coding Agent.</p><p>The value is either:</p><div class="itemizedlist"><ul class="itemizedlist " style="list-style-type: disc;"><li class="listitem"><p>Inline content as a string</p></li><li class="listitem"><p>A path to a file containing the content</p></li></ul></div><p>The configured content is written to
+<code class="filename">AGENTS.md</code> inside
+<code class="option">programs.pi-coding-agent.configDir</code>
+(default <code class="filename">~/.pi/agent/AGENTS.md</code>).</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+strings concatenated with “\n” or absolute path</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">&quot;&quot;
+</code></pre>
+
+<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting nix">./pi-context.md
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.extraPackages"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.extraPackages"><code class="option">programs.pi-coding-agent.extraPackages</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>Extra packages available to Pi Coding Agent.
+These are added to the PATH of the wrapped pi binary.</p><p>Needed for packages installed by pi (e.g.
+<span class="command"><strong>npm:@termdraw/pi</strong></span> requires <span class="command"><strong>npm</strong></span> and
+<span class="command"><strong>bun</strong></span>).</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+list of package</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">[ ]
+</code></pre>
+
+<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting nix">[ pkgs.nodejs pkgs.bun ]
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.keybindings"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.keybindings"><code class="option">programs.pi-coding-agent.keybindings</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>Keybindings configuration written to
+<code class="filename">~/.pi/agent/keybindings.json</code>.
+See <a class="link" href="https://pi.dev/docs/latest/keybindings"  target="_top">https://pi.dev/docs/latest/keybindings</a> for the
+documentation.</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+JSON value</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">{ }
+</code></pre>
+
+<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting nix">{
+  &quot;tui.editor.cursorDown&quot; = [
+    &quot;down&quot;
+    &quot;ctrl+n&quot;
+  ];
+  &quot;tui.editor.cursorUp&quot; = [
+    &quot;up&quot;
+    &quot;ctrl+p&quot;
+  ];
+  &quot;tui.editor.deleteWordBackward&quot; = [
+    &quot;ctrl+w&quot;
+    &quot;alt+backspace&quot;
+  ];
+}
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.models"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.models"><code class="option">programs.pi-coding-agent.models</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>Custom model providers written to
+<code class="filename">~/.pi/agent/models.json</code>.</p><p>Each provider entry may contain <code class="literal">baseUrl</code>,
+<code class="literal">api</code>, <code class="literal">apiKey</code>, <code class="literal">compat</code>, and a <code class="literal">models</code>
+list with <code class="literal">id</code>, <code class="literal">name</code>, <code class="literal">reasoning</code>, etc.</p><p>See <a class="link" href="https://pi.dev/docs/latest/models"  target="_top">https://pi.dev/docs/latest/models</a> for the
+documentation.</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+JSON value</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">{ }
+</code></pre>
+
+<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting nix">{
+  providers = {
+    ollama = {
+      api = &quot;openai-completions&quot;;
+      apiKey = &quot;ollama&quot;;
+      baseUrl = &quot;http://localhost:11434/v1&quot;;
+      models = [
+        {
+          id = &quot;llama3.1:8b&quot;;
+        }
+      ];
+    };
+  };
+}
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
+<dt>
+ <span class="term">
+ <a id="opt-programs.pi-coding-agent.settings"></a><a class="term" href="options.xhtml#opt-programs.pi-coding-agent.settings"><code class="option">programs.pi-coding-agent.settings</code>
+  </a>
+ </span>
+</dt>
+<dd>
+<p>Configuration written to
+<code class="filename">~/.pi/agent/settings.json</code>.
+See <a class="link" href="https://pi.dev/docs/latest/settings"  target="_top">https://pi.dev/docs/latest/settings</a> for the
+documentation.</p>
+
+<p><span class="emphasis"><em>Type:</em></span>
+JSON value</p>
+
+<p><span class="emphasis"><em>Default:</em></span></p><pre><code class="programlisting nix">{ }
+</code></pre>
+
+<p><span class="emphasis"><em>Example:</em></span></p><pre><code class="programlisting nix">{
+  compaction = {
+    enabled = true;
+    keepRecentTokens = 20000;
+    reserveTokens = 16384;
+  };
+  defaultModel = &quot;claude-sonnet-4-20250514&quot;;
+  defaultProvider = &quot;anthropic&quot;;
+  defaultThinkingLevel = &quot;medium&quot;;
+  enabledModels = [
+    &quot;claude-*&quot;
+    &quot;gpt-4o&quot;
+  ];
+  packages = [
+    &quot;npm:@termdraw/pi&quot;
+    &quot;npm:pi-mcp-adapter&quot;
+  ];
+  retry = {
+    enabled = true;
+    maxRetries = 3;
+  };
+  theme = &quot;dark&quot;;
+}
+</code></pre>
+
+<p><span class="emphasis"><em>Declared by:</em></span></p>
+<table border="0" summary="Simple list" class="simplelist">
+<tr><td>
+<code class="filename"><a class="filename"  href="https://github.com/nix-community/home-manager/blob/master/modules/programs/pi-coding-agent.nix" target="_top">
+&lt;home-manager/modules/programs/pi-coding-agent.nix&gt;
+</a></code>
+</td></tr>
+</table>
+</dd>
 <dt>
 <span class="term">
 <a id="opt-programs.pianobar.enable"></a><a class="term" href="options.xhtml#opt-programs.pianobar.enable"><code class="option">programs.pianobar.enable</code>