rust-bash 0.3.0

A sandboxed bash interpreter for AI Agents with a virtual filesystem
Documentation 
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

<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1, user-scalable=no">
  <title>rust-bash — A sandboxed bash interpreter, built in Rust</title>
  <meta name="description"
    content="Execute bash scripts safely with a virtual filesystem — no containers, no VMs, no host access. Running in your browser via WASM.">
  <meta name="keywords" content="bash, shell, interpreter, sandbox, wasm, rust, virtual filesystem, AI agent">

  <!-- Open Graph -->
  <meta property="og:title" content="rust-bash — Sandboxed Bash in Your Browser">
  <meta property="og:description"
    content="80+ commands, virtual filesystem, execution limits. Built in Rust, compiled to WASM, running entirely in your browser.">
  <meta property="og:type" content="website">
  <meta property="og:url" content="https://rustbash.dev">
  <meta property="og:image" content="https://rustbash.dev/og-image.png">
  <meta property="og:image:width" content="1200">
  <meta property="og:image:height" content="630">

  <!-- Twitter Card -->
  <meta name="twitter:card" content="summary_large_image">
  <meta name="twitter:title" content="rust-bash — Sandboxed Bash in Your Browser">
  <meta name="twitter:description"
    content="80+ commands, virtual filesystem, execution limits. Built in Rust, compiled to WASM.">
  <meta name="twitter:image" content="https://rustbash.dev/og-image.png">

  <link rel="icon"
    href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🦀</text></svg>">
  <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=Fira+Mono:wght@400;500;700&display=swap" rel="stylesheet">

  <link rel="stylesheet" href="./styles.css">
</head>

<body>
  <!-- CRT monitor bezel -->
  <div id="crt-bezel">
    <span class="bezel-label">rust-bash</span>

    <!-- Screen area (recessed glass) -->
    <div id="crt-screen">
      <!-- CRT overlay effects (scanlines + glare) -->
      <div id="crt-frame"></div>

      <!-- "Wake up, Neo..." intro screen -->
      <div id="intro">
        <div><span id="intro-text"></span><span id="intro-cursor"></span></div>
      </div>

      <!-- Main app container (hidden until intro finishes) -->
      <div id="app" class="hidden">
        <header id="header">
          <div class="header-left">
            <span class="header-logo">🦀</span>
            <span class="header-title">rust-bash</span>
          </div>
          <a href="https://github.com/shantanugoel/rust-bash" target="_blank" rel="noopener" class="header-github"
            aria-label="GitHub repository">
            <svg width="20" height="20" viewBox="0 0 16 16" fill="currentColor">
              <path
                d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z" />
            </svg>
          </a>
        </header>

        <main id="terminal-container">
          <div id="terminal"></div>
        </main>

        <footer id="footer">
          <span>MIT</span>
          <span class="footer-sep">·</span>
          <span>Built in Rust</span>
          <span class="footer-sep">·</span>
          <span>Runs Everywhere</span>
        </footer>
      </div>
    </div>

    <!-- Power LED -->
    <div class="bezel-bottom">
      <div class="power-led"></div>
    </div>
  </div>

  <!-- Noscript fallback -->
  <noscript>
    <div style="background:#0a0a0a;color:#b0ffb0;font-family:monospace;padding:2rem;min-height:100vh;">
      <pre style="color:#f74c00;font-size:0.65rem;line-height:1.15;">
                    __  __               __
   _______  _______/ /_/ /_  ____ ______/ /_
  / ___/ / / / ___/ __/ __ \/ __ `/ ___/ __ \
 / /  / /_/ (__  ) /_/ /_/ / /_/ (__  ) / / /
/_/   \__,_/____/\__/_.___/\__,_/____/_/ /_/
      </pre>
      <p style="margin:1rem 0;">🦀 A sandboxed bash interpreter, built in Rust.</p>
      <p style="margin:1rem 0;">This interactive demo requires JavaScript. To use rust-bash locally:</p>
      <pre style="margin:1rem 0;padding:1rem;background:#111;border-radius:4px;">
cargo install rust-bash
rust-bash -c 'echo "Hello from rust-bash!"'
      </pre>
      <p><a href="https://github.com/shantanugoel/rust-bash" style="color:#5af;">View on GitHub →</a></p>
    </div>
  </noscript>

  <script type="module" src="./main.ts"></script>
</body>

</html>