Does this skill support network socket operations?

While bun.sys supports limited operations like setsockopt, for non-blocking network I/O it is recommended to use uws.Socket (libuwebsockets) as per the skill's best practices.

What is the Maybe(T) return type used in this skill?

Maybe(T) is a tagged union used by bun.sys that returns either the successful result or a detailed error object containing the errno, the specific syscall that failed, and relevant path or FD info.

How do I handle file closing with bun.sys?

You should use the close() method on bun.FD, typically within a defer statement. For cases requiring error handling during close, use the closeAllowingBadFileDescriptor method.

Why should I use bun.sys instead of std.fs in Zig?

bun.sys provides superior cross-platform compatibility (especially for Windows via libuv), automatic EINTR retries, and more detailed error information including syscall tags and file descriptors.

Zig System Calls (bun.sys)

Name: Zig System Calls (bun.sys)
Author: xhochy

byxhochy

0•

Developer Tools

Implements cross-platform file I/O and system calls using the Bun runtime's internal Zig utilities.

This skill provides specialized guidance for developers working within the Bun codebase or using Bun's Zig internals to perform system-level operations. It facilitates the transition from standard Zig library calls (std.fs, std.posix) to the more robust bun.sys namespace. By leveraging bun.sys, developers gain access to full Windows support via libuv fallbacks, automatic EINTR retry logic, and highly detailed error reporting through the Maybe(T) tagged union pattern. It is an essential tool for ensuring performant, cross-platform file and directory management in Zig environments powered by Bun.

Key Features

01Detailed error handling using the Maybe(T) tagged union pattern

02Cross-platform file I/O with native Windows and libuv support

03Efficient directory iteration with bun.DirIterator

04Automatic EINTR retry handling for system calls

05Platform-normalized file flags using the bun.O namespace

060 GitHub stars

Use Cases

01Porting existing Zig applications to be fully cross-platform with Windows support

02Developing or contributing to the Bun runtime or its internal Zig modules

03Implementing high-performance system utilities requiring granular error reporting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add xhochy/bun-1.3.7 zig-system-calls

For use in Claude.ai and ChatGPT

Download Skill