otter-utils - Otter Shell

otter-utils sits at the bottom of the stack. Pure Zig, no external deps. Every other library links it for bounded containers, path helpers, logging, file watching, and shared XDG paths under ~/.config/otter-shell/.

Quick example

const utils = @import("otter_utils");

var arr = utils.BoundedArray(u8, 256){};
try arr.appendSlice("hello");

const mylog = utils.log.Scoped("my-app");
mylog.info("starting", .{});

var path_buf: [std.fs.max_path_bytes]u8 = undefined;
const config_path = utils.config_paths.otterConfigPath(&path_buf, "myapp.conf") orelse return error.NoHome;

Documentation map

Arrays and paths

BoundedArray, FilePath, FixedString, and stack buffers.

Logging

Scoped loggers, counters, timers, and periodic reporters.

Inotify

Generic file and directory watcher for event loops.

Config and runtime paths

XDG config, data, cache, runtime dirs, and runtime_state.

Other exports

Module	Purpose
`process` / `command`	Spawn subprocesses with bounded argv
`SubscriberList`	Lightweight pub/sub for state changes
`unix_socket`	Bounded Unix socket paths and FD hardening
`app_id_match`	Match Wayland `app_id` strings
`assist`	ChatML prompt helpers for `otter-assist`
`cli`	Shared CLI flag parsing for small tools

Dependencies

None.

Libraries overview

Arrays and paths

⌘I

​Quick example

​Documentation map

Arrays and paths

Logging

Inotify

Config and runtime paths

​Other exports

​Dependencies

Quick example

Documentation map

Other exports

Dependencies