SYD-EMACS(1)

💅 SYD-EMACS(1) — like, the Gen Z field guide ✨

okay so bestie, you're looking at syd-emacs, straight out of the General Commands Manual (that's the manual name, we're folding it in right here at the top so nobody forgets 🎀). buckle up, she's short but she's iconic.

---

🌸 NAME 🌸

syd-emacs — the convenience wrapper that runs Emacs under Syd. yes. that's the whole pitch. it's giving "little script, big job" energy fr fr 🫶

---

✨ SYNOPSIS ✨

syd-emacs [command-line switches] [files...]

---

💖 DESCRIPTION 💖

so syd-emacs is a convenience wrapper to run Emacs under Syd. that's it, that's the vibe. all command-line arguments are passed directly to emacs(1) — no filtering, no meddling, no "not me rewriting your flags" nonsense. she just forwards them 💅

---

🦋 FILES 🦋

• /dev/syd.el — the Emacs Lisp syd(2) API library. to access it, the sandbox lock has to be accessible, ie "lock:off" or "lock:exec". iykyk 🔑
• ~/.emacs.d/init.syd-3 — your Emacs Syd profile. if this file does not exist, the "lib" profile gets used instead. and bestie, listen: the "lib" profile turns all sandboxing off and sets "lock:exec" so that access to the virtual file /dev/syd.el works. 😭 if you don't want all your sandboxing off, you're encouraged to configure a profile with this file. and make sure you add "lock:exec" at the end so the initial emacs(1) process can reach the sandbox and load /dev/syd.el — that part matters 💀

also: ensure you call (syd-lock :lock-on) from within emacs(1) once you're done configuring syd(1) using the syd(2) API. periodt.

and if you don't want to allow access to the sandbox lock at all? totes fair — you're encouraged to call syd(1) manually with emacs(1). because bestie, let's be real: this is just a convenience wrapper 🎀

• ~/.emacs.d/syd.log — the Emacs Syd log file, where access violations get logged. syd-emacs(1) opens this file and sets the SYD_LOG_FD environment variable to the value of the file descriptor. and it's opened for create+append-only — no rewriting history over here 🫶

---

🌈 SEE ALSO 🌈

syd(1), syd(2), syd(5), emacs(1)

syd homepage: https://sydbox.exherbo.org/

---

👑 AUTHORS 👑

maintained by Ali Polatel (slay). up-to-date sources can be found at https://gitlab.exherbo.org/sydbox/sydbox.git and on Radicle at rad:z38HCnbmcDegA2BMxuPaPRPMdp6wF. bugs/patches can be submitted to https://gitlab.exherbo.org/groups/sydbox/-/issues. wanna discuss? come hang in #sydbox on Libera Chat or in #sydbox:mailstation.de on Matrix. main character energy only 💜

---

⭐ okay that's the whole page, no cap. this edition was served fresh on 2026-09-01 — catch you in the next release, bestie 💖🦋