lucifer1004

lucifer1004 / conch

Public

A shell simulator for Typst

shell typst vfs
19
0
100% credibility
Found Apr 11, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Conch simulates realistic shell terminals inside Typst documents, letting users type commands against a virtual filesystem with colors, pipes, and themes for demos.

How It Works

1
📚 Discover conch

While creating a document or presentation, you find conch to add realistic terminal demos without real coding.

2
🖥️ Add a terminal window

Place a simple terminal block in your document where you want the demo to appear.

3
📁 Set up pretend files

List a few fake files and folders inside the terminal setup, like notes or code snippets.

4
⌨️ Type everyday commands

Write commands like 'ls' to list files or 'cat' to show content, and watch them work just like a real computer.

5
🔗 Chain commands with pipes

Connect commands like 'ls | grep code' to filter and transform output in clever ways.

6
🎨 Choose a theme and style

Pick a color scheme or window look to match your document's vibe.

✨ Perfect demo ready

Your document now shines with lifelike terminal sessions that impress everyone who sees it.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is conch?

Conch is a bash shell simulator that lets you embed interactive terminal sessions directly into Typst documents using Rust-compiled WASM. Define a virtual filesystem with real files from your project, then type commands like `ls | grep .rs`, `cat main.rs`, or chained pipelines—they execute with pipes, redirects, variables, globs, and Unix permissions, rendering as a themed terminal with syntax highlighting and ANSI colors. It's a github shell commands emulator for docs, turning static screenshots into dynamic demos without leaving Typst.

Why is it gaining traction?

It stands out by layering simplicity: grab a terminal frame for any content, add ANSI rendering, or go full shell simulator with 80+ commands like grep, sed, tree, and user management. Per-char animations simulate typing with backspaces, arrows, and history navigation, perfect for GIFs via ffmpeg integration. Developers love the realistic output—colored ls, highlighted cat for Rust/Python/JS—far beyond basic syntax highlighters.

Who should use this?

Typst authors building tutorials, READMEs, or slides with CLI demos; devrel folks showcasing build logs or scripts; presentation makers needing animated terminals for tools like cargo or npm. Ideal if you're tired of screenshot hell for github shell linux sessions or killer shell simulator effects in docs.

Verdict

Grab it for Typst projects—docs are excellent, features deliver polish out of the box. At 19 stars and 1.0% credibility, it's early but stable; test thoroughly before production. (187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.