opensh.org/index.html at main · openshellorg/opensh.org · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>OpenShellOrg</title>
    <meta
      name="description"
      content="Shared rules for CLI tools and small helpers around better shells — especially Nushell. Not another shell language."
    />
    <script>
      (function () {
        var dark = window.matchMedia("(prefers-color-scheme: dark)").matches;
        document.documentElement.setAttribute("data-theme", dark ? "dark" : "light");
      })();
    </script>
    <link rel="icon" href="assets/logo-mark.svg" type="image/svg+xml" />
    <link rel="preconnect" href="https://fonts.googleapis.com" />
    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
    <link
      href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@500;700&family=IBM+Plex+Sans:wght@400;600;700&display=swap"
      rel="stylesheet"
    />
    <link rel="stylesheet" href="assets/site.css?v=home-plain-2" />
    <link rel="alternate" type="application/rss+xml" title="OpenShellOrg News" href="news/feed.xml" />
  </head>
  <body>
    <button type="button" class="theme-toggle" data-theme-toggle aria-label="Switch color theme">
      <svg class="icon-sun" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true">
        <circle cx="12" cy="12" r="4" />
        <path d="M12 2v2M12 20v2M4.93 4.93l1.41 1.41M17.66 17.66l1.41 1.41M2 12h2M20 12h2M4.93 19.07l1.41-1.41M17.66 6.34l1.41-1.41" />
      </svg>
      <svg class="icon-moon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true">
        <path d="M21 14.5A8.5 8.5 0 1 1 9.5 3 7 7 0 0 0 21 14.5z" />
      </svg>
    </button>
    <main class="shell">
      <section class="hero">
        <img class="mark" src="assets/logo-mark.svg" width="256" height="256" alt="OpenShellOrg" />
        <h1>OpenShellOrg</h1>
        <p class="tag">
          Better shells. Better CLIs. Less friction.
        </p>
        <p class="tag-sub">
          We write shared rules for command-line tools, certify tools that follow them, and ship
          small helpers around better shells — especially
          <a href="https://www.nushell.sh/">Nushell</a>.
          We do not invent another shell language.
        </p>
        <div class="cta">
          <a class="primary" href="https://docs.opensh.org/">Docs</a>
          <a class="secondary" href="https://docs.opensh.org/open-shell-org/philosophy.html">Philosophy</a>
          <a class="secondary" href="https://github.com/openshellorg">GitHub</a>
          <a class="secondary" href="news/">News</a>
        </div>
        <p class="note">
          Not
          <a href="https://github.com/NVIDIA/OpenShell">NVIDIA OpenShell</a>
          (agent sandbox runtime).
        </p>
      </section>

      <section class="story" aria-labelledby="care-heading">
        <h2 id="care-heading">Three bets</h2>
        <ul class="idea-list">
          <li>
            <strong>Flags you can learn once</strong>
            SOS (“Save Our Syntax”) is a shared spelling for common options, plus a mark for
            tools that keep that promise.
          </li>
          <li>
            <strong>Pipes that carry real data</strong>
            Classic shells jam “data for the next command” and “layout for your eyes” into the
            same stream. Structured shells pass tables between commands and only format what you
            see at the end. We endorse Nushell as the Unix-centric reference — we document the
            model and ship helpers; we do not reinvent it.
          </li>
          <li>
            <strong>Honesty when you hit Enter</strong>
            If a project asks for a specific toolchain, the process that starts should be that
            one — or the tool should install what’s needed and restart <em>this</em> command,
            without rewriting the machine default.
            <span class="idea-more">
              <a href="https://docs.opensh.org/shell-architecture/entrypoint-dispatch.html">Entrypoint Dispatch</a>
            </span>
          </li>
        </ul>
      </section>

      <section class="story" aria-labelledby="exists-heading">
        <h2 id="exists-heading">What exists today</h2>
        <ul class="catalog">
          <li>
            <span class="catalog-title"><a href="https://docs.opensh.org/">Docs</a></span>
            <span>Philosophy, SOS, and shell-architecture essays in one place.</span>
          </li>
          <li>
            <span class="catalog-title"><a href="https://github.com/openshellorg/shell-architecture">shell-architecture</a></span>
            <span>The thesis: structured pipelines, entrypoint honesty, division of labor.</span>
          </li>
          <li>
            <span class="catalog-title"><a href="https://github.com/openshellorg/about">about</a></span>
            <span>Orient yourself on a strange machine — OS, shell, and how to look around.</span>
          </li>
          <li>
            <span class="catalog-title"><a href="https://github.com/openshellorg/prohelp">prohelp</a></span>
            <span>Progressive help for CLIs — the right depth when you ask.</span>
          </li>
          <li>
            <span class="catalog-title">
              <a href="https://github.com/openshellorg/nu-require">nu-require</a>
              /
              <a href="https://github.com/openshellorg/nu-emit">nu-emit</a>
            </span>
            <span>Small Nushell companions for require and emit patterns.</span>
          </li>
        </ul>
      </section>

      <section class="story" aria-labelledby="sibling-heading">
        <h2 id="sibling-heading">A sibling workshop to DevCentr</h2>
        <p class="lede">
          File us next to
          <a href="https://devcentr.org">DevCentr</a>:
          that org helps teams set up and keep healthy environments;
          OpenShellOrg writes what command-line tools and shells should agree on.
          Two desks on the same floor — environments on one side, CLI/shell standards on the other.
        </p>
        <p class="story-more">
          <a href="https://docs.devcentr.org/general-knowledge/explanation/infrastructure/toolchain-management.html">Toolchain Management</a>
          ·
          <a href="https://docs.opensh.org/open-shell-org/philosophy.html">Philosophy</a>
        </p>
      </section>
    </main>
    <footer class="site-footer" aria-label="Site footer">
      <p class="footer-related-label">Related projects</p>
      <p class="footer-related-links">
        <a href="https://opensh.org/">OpenShellOrg</a>
        ·
        <a href="https://devcentr.org">DevCentr</a>
        ·
        <a href="https://github.com/dlang-supplemental">dlang-supplemental</a>
      </p>
    </footer>
    <script src="assets/theme.js?v=home-plain" defer></script>
  </body>
</html>