otty / apps

All apps/TinyFugue

TinyFugue

tinyfugue

A rebirth of the TinyFugue MUD client: a programmable, screen-oriented client for text-based multi-user games.

Runs as tf|macOS, Linux|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

TinyFugue in your home directory Every rule on this page, by file

/test addworld(

Lifted into your secret store; the rest of the file syncs.

/test addworld(

Lifted into your secret store; the rest of the file syncs.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/tinyfugue/otty.tomlThe file this page is generated from

id = "tinyfugue"

name = "TinyFugue"

homepage = "https://github.com/ingwarsw/tinyfugue"

description = "A rebirth of the TinyFugue MUD client: a programmable, screen-oriented client for text-based multi-user games."

# The binary TinyFugue installs is `tf`.

executables = ["tf"]

platforms = ["macos", "linux"]

[dotfiles]

# src/main.c, the startup path, tries the personal config file in this order:

# do_file_load("~/.tfrc", TRUE, &main_configfile) >= 0 ||

# do_file_load("~/tfrc", TRUE, &main_configfile) >= 0 ||

# do_file_load("./.tfrc", ...) || do_file_load("./tfrc", ...)

# and the usage text calls it "-f don't load personal config file (.tfrc)".

# The two home-directory spellings are listed; the two ./ ones are per-project

# files in whatever directory tf was started from, not user config.

paths = [

"~/.tfrc",

"~/tfrc",

]

exclude = []

# Nothing here is a credential end to end — a .tfrc is macros, triggers, key

# bindings and world definitions together. The passwords inside it are named

# below instead.

secret = []

# tf reads the file once at startup and holds nothing open on it afterwards.

side_effect = false

# A world definition carries the character's password for that MUD. TinyFugue

# stores it as the world's `pass` field, and /saveworld writes the world list

# back out through the same formatter /listworlds uses, which builds each line

# as `/test addworld(` followed by the quoted name, type, host, port,

# character, pass, macro file and flags (src/world.c, listworld_body:

# Stringcpy(buf, "/test addworld("); … Sappendf(buf, ", \"%q\"", '"', p->pass)).

# So the whole call is held back: the password is the sixth argument of a line

# this syntax can only match whole. Both home-directory spellings are named,

# because a rule bound to only one of them would not run for a user who has

# the other.

[[dotfiles.secret_paths]]

file = ["~/.tfrc", "~/tfrc"]

match = { prefix = ["/test addworld("] }

# No machine_lines: macros, triggers, hooks and key bindings are the point of

# carrying a .tfrc, and a world's host and port belong to the MUD rather than

# to one of the user's computers.

[commands]

format = 1

label = "Connect to a MUD"

description = "Start TinyFugue and connect to a world or host. Library directory and startup command are left out."

quality = "ai-draft"

parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = true, short_bundles = true }

[[commands.source]]

id = "usage"

kind = "help"

url = "https://github.com/ingwarsw/tinyfugue/blob/HEAD/src/main.c"

revision = "2026-10-27"

evidence = """

Usage: tf [-L<dir>] [-f[<file>]] [-c<cmd>] [-vnlq] [<world>]

tf [-L<dir>] [-f[<file>]] [-c<cmd>] [-vlq] <host> <port>

-f don't load personal config file (.tfrc)

-f<file> load <file> instead of config file

-n no automatic first connection

-l no automatic login/password

-q quiet login

-v no automatic visual mode

<host> hostname or IP address

<port> port number or name

<world> connect to <world> defined by addworld()

"""

[[commands.field]]

id = "world"

label = "World or host"

description = "A world defined by addworld(), or a hostname/IP when a port follows."

type = "string"

position = 0

sources = ["usage"]

[[commands.field]]

id = "port"

label = "Port"

description = "Only with a hostname instead of a world."

type = "string"

position = 1

sources = ["usage"]

[[commands.field]]

id = "config_file"

label = "Config file"

description = "Load this file instead of ~/.tfrc."

type = "path"

option = ["-f"]

path = { kind = "file", role = "input" }

sources = ["usage"]

[[commands.field]]

id = "no_connect"

label = "No automatic first connection"

type = "boolean"

option = ["-n"]

sources = ["usage"]

[[commands.field]]

id = "no_login"

label = "No automatic login"

type = "boolean"

option = ["-l"]

sources = ["usage"]

[[commands.field]]

id = "quiet"

label = "Quiet login"

type = "boolean"

option = ["-q"]

sources = ["usage"]

[[commands.field]]

id = "no_visual"

label = "No automatic visual mode"

type = "boolean"

option = ["-v"]

sources = ["usage"]

[[commands.task]]

id = "connect_world"

label = "Connect to a world"

fields = ["world"]

required = ["world"]

[[commands.task]]

id = "connect_host"

label = "Connect to host and port"

fields = ["world", "port"]

required = ["world", "port"]

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["world", "port", "config_file"]

[[commands.group]]

id = "advanced"

label = "Advanced"

fields = ["no_connect", "no_login", "quiet", "no_visual"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/tinyfugue. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.