Commit fe4135c

Eric Bower  ·  2026-05-09 13:01:19 -0400 EDT
parent e08a892
docs: copy
1 files changed,  +33, -14
+33, -14
......@@ -516,7 +516,7 @@ code {
516516 ============================================================ -->
517517 <nav>
518518 <div class="container">
519- <div class="logo">pici <span>— terminal-first CI</span></div>
519+ <div class="logo">pici <span>: terminal-first CI</span></div>
520520 <ul>
521521 <li><a href="#how">How It Works</a></li>
522522 <li><a href="#infra">Infra</a></li>
......@@ -565,7 +565,7 @@ code {
565565 <span class="dot red"></span>
566566 <span class="dot yellow"></span>
567567 <span class="dot green"></span>
568- <span style="margin-left: 0.5rem;">ci-myrepo-test — build log</span>
568+ <span style="margin-left: 0.5rem;">ci-myrepo-test: build log</span>
569569 </div>
570570 <div class="terminal-body">
571571 <div class="output">Line 1847: ...</div>
......@@ -594,7 +594,7 @@ code {
594594 <div class="two-col">
595595 <div>
596596 <p>
597- Every build step in pici runs as a <strong>real terminal session</strong> — a PTY you can attach to.
597+ Every build step in pici runs as a <strong>real terminal session</strong>: a PTY you can attach to.
598598 No "enable debugging" flag. No "re-run with SSH" button. No waiting for a tunnel.
599599 </p>
600600 <p>
......@@ -602,10 +602,10 @@ code {
602602 inspect the environment, fix the issue. You're already there.
603603 </p>
604604 <ul class="check-list">
605- <li><code>zmx attach ci.myrepo.test</code> — you're in</li>
605+ <li><code>zmx attach ci.myrepo.test</code> to jump in</li>
606606 <li>Press <code>↑</code> to rerun the failing command</li>
607607 <li>Inspect files, env vars, network state</li>
608- <li>No debug mode — it's just a terminal</li>
608+ <li>No debug mode. It's just a terminal.</li>
609609 </ul>
610610 </div>
611611 <div>
......@@ -639,7 +639,7 @@ code {
639639 <div><span class="comment">#!/usr/bin/env bash</span></div>
640640 <div><span class="cmd">set -euo pipefail</span></div>
641641 <div>&nbsp;</div>
642- <div><span class="comment"># These run in parallel — no config needed</span></div>
642+ <div><span class="comment"># These run in parallel, no config needed</span></div>
643643 <div><span class="cmd">zmx run lint docker run golangci-lint run</span></div>
644644 <div><span class="info"> → started session: ci.myrepo.lint</span></div>
645645 <div>&nbsp;</div>
......@@ -769,12 +769,31 @@ code {
769769 </p>
770770 <div style="text-align:center; margin-top: 1rem;">
771771 <span style="background: var(--surface); padding: 0.3rem 0.8rem; border-radius: 4px; font-size: 0.85rem; color: var(--yellow);">
772- Bring your own isolation — docker, namespaces, bare metal. You choose.
772+ Bring your own isolation: docker, namespaces, bare metal. You choose.
773773 </span>
774774 </div>
775775 </div>
776776 </section>
777777
778+<!-- ============================================================
779+ PHILOSOPHY
780+ ============================================================ -->
781+<section id="philosophy">
782+ <div class="container" style="max-width: 640px; margin: 0 auto; text-align: center;">
783+ <p class="section-label">Who It's For</p>
784+ <h2 style="justify-content: center;">CI that works for you, not against you.</h2>
785+ <p>
786+ pici is built for individuals and small teams who want to move fast. You write a bash
787+ script, you push your code, your build runs, and if something breaks you jump into the
788+ terminal and fix it. No YAML labyrinths, no approval workflows, no 400-page admin guide.
789+ </p>
790+ <p>
791+ We're not building enterprise CI. You won't find SSO, RBAC, or audit logs here.
792+ What you will find is a system that gets out of your way and lets you ship.
793+ </p>
794+ </div>
795+</section>
796+
778797 <!-- ============================================================
779798 POWERED BY deploy.pico.sh
780799 ============================================================ -->
......@@ -785,7 +804,7 @@ code {
785804 <div class="two-col">
786805 <div>
787806 <p>
788- <strong>ci.pico.sh</strong> runs on <strong>deploy.pico.sh</strong> — our SSH VM service
807+ <strong>ci.pico.sh</strong> runs on <strong>deploy.pico.sh</strong>: our SSH VM service
789808 on hardware we own. Not AWS. Not GCP. Not a cloud provider.
790809 </p>
791810 <p>
......@@ -797,10 +816,10 @@ code {
797816 The same platform that runs your CI runs your apps.
798817 </p>
799818 <ul class="check-list">
800- <li>Our hardware — not a hyperscaler</li>
819+ <li>Our hardware, not a hyperscaler</li>
801820 <li>Docker Compose via <code>git push</code></li>
802821 <li>Expose HTTP services with compose labels</li>
803- <li>Limited inventory — when it's gone, it's gone</li>
822+ <li>Limited inventory: when it's gone, it's gone</li>
804823 </ul>
805824 </div>
806825 <div class="terminal">
......@@ -848,7 +867,7 @@ code {
848867 <div class="feature-card">
849868 <h3>AI-Agent Friendly</h3>
850869 <p>
851- Terminal workflows, rsync + SSH pubsub, JSONL status streams — everything an agent
870+ Terminal workflows, rsync + SSH pubsub, JSONL status streams. Everything an agent
852871 needs to trigger builds, monitor progress, and attach to failures. No OAuth flows,
853872 no API rate limits, no webhooks. An agent can start as many jobs as it wants
854873 and read results as structured text.
......@@ -866,7 +885,7 @@ code {
866885 <h3>Static Site Artifacts</h3>
867886 <p>
868887 Build artifacts are plain HTML + CSS. No JavaScript. No app server. No build step.
869- Serve the directory with any static host — nginx, s3, pgs.sh, <code>python -m http.server</code>.
888+ Serve the directory with any static host: nginx, s3, pgs.sh, <code>python -m http.server</code>.
870889 Zero runtime dependencies.
871890 </p>
872891 </div>
......@@ -927,12 +946,12 @@ code {
927946 <div class="error">FAIL myapp/api (14.2s)</div>
928947 <div class="error">Error: connection refused</div>
929948 <div>&nbsp;</div>
930- <div class="comment"># you're in the session — inspect freely</div>
949+ <div class="comment"># you're in the session, inspect freely</div>
931950 <div><span class="prompt">$ </span><span class="cmd">cat .env</span></div>
932951 <div class="output">DB_HOST=postgres.internal:5432</div>
933952 <div><span class="prompt">$ </span><span class="cmd">nc -zv postgres.internal 5432</span></div>
934953 <div class="error">Connection refused</div>
935- <div><span class="comment"># ↑ found it — wrong hostname</span></div>
954+ <div><span class="comment"># ↑ found it: wrong hostname</span></div>
936955 <div><span class="comment"># ↑ press ↑ to rerun the test after fixing</span></div>
937956 </div>
938957 </div>