sigi(1)

🌴 sigi(1) · USER COMMANDS · an organizing tool for terminal lovers who hate organizing

💖 NAME

sigi — An organizing tool for terminal lovers who hate organizing.

✨ SYNOPSIS ✨

sigi [FLAGS] [OPTIONS] [SUBCOMMAND]

🦋 DESCRIPTION 🦋

okay so use sigi as extra memory. Use it to organize your tasks, groceries, or the next board games you want to play... as stacks! Shell aliases are strongly encouraged to organize your various stacks.

sigi is the Chamorro word for continue. I hope this will help you to plan more, forget less, get things done, and relax. 💜

💅 FLAGS 💅

• -h, --help — Prints help information. ✨
• -q, --quiet — Omit any leading labels or symbols. Recommended for use in shell scripts.
• -s, --silent — Omit any output at all. like, absolutely zero output.
• -V, --version — Prints version information.
• -v, --verbose — Prints more information, like when an item was created. [Aliases: --noisy]

🎀 OPTIONS 🎀

• -f, --format <FORMAT> — Use a programmatic FORMAT. Options include: [csv, json, json-compact, tsv].
• -t, --stack <STACK> — Manage items in a specific STACK. If no STACK is provided, it will use "sigi" by default. It's recommended to use shell aliases to access your stacks. (See EXAMPLES below.) Or: --topic, --about, --namespace <STACK>.
• -d, --data-store <DATA_STORE> — (Advanced) Manage sigi stacks in a specific directory. The default is either the value of a SIGI_HOME environment variable or your OS-specific home directory [aliases: dir, directory, store].

🌈 SUBCOMMANDS 🌈

• - — Read input lines from standard input. Same commands as interactive mode, but only prints for printing commands. Intended for use in unix pipes.
• complete — Move the current item to <STACK>_history and mark as completed [aliases: done, finish, fulfill].
• count — Print the total number of items in the stack [aliases: size, length].
• delete — Move the current item to <STACK>_history and mark as deleted. [aliases: pop, remove, cancel, drop].
• delete-all — Move all items to <STACK>_history and mark as deleted [aliases: purge, pop-all, remove-all, cancel-all, drop-all].
• edit — Edit the content of an item. Other metadata like creation date is left unchanged.
• enqueue — Create a new item at the bottom/beginning of the stack. Effectively allows queue behavior [aliases: enq, prepend].
• head N — Print the first N items [aliases: top, first].
• help — Prints a help message or the help of the given subcommand(s).
• interactive — Run in an interactive mode [aliases: i].
• is-empty — Prints "true" if stack has zero items, or prints "false" (fails with a nonzero exit code) if the stack does have items [aliases: empty].
• list — Print all items [aliases: ls, snoop, show, all].
• list-stacks — Print all stacks [aliases: stacks].
• move — Move current item to another stack.
• move-all — Move all items to another stack.
• next — Cycle to the next item; the current item becomes last [aliases: later, cycle, bury].
• peek — Print the first item. (This is the default behavior when no command is given) [aliases: show].
• pick — Move items to the top of stack by their number.
• push — Create a new item [aliases: create, add, do, start, new].
• rot — Rotate the three most-current items [aliases: rotate].
• swap — Swap the two most-current items.
• tail — Print the last N items [aliases: bottom, last].

🧚 INTERACTIVE MODE 🧚

Use subcommands in interactive mode directly, bestie. For example:

🌴 ▶ push a new thing
Created: a new thing
🌴 ▶ peek
Now: a new thing
🌴 ▶ delete
Deleted: a new thing
Now: nothing
🌴 ▶ exit
exit: Buen biåhe!

No OPTIONS (flags) of subcommands are understood in interactive mode. 💀

The ; character can be used to separate commands.

The following additional commands are available:

• ? — "Show the short version of"
• clear — Clear the terminal screen.
• use — Change to the specified stack [aliases: stack].
• exit — Quit interactive mode [aliases: quit, q].

🌸 EXAMPLES, CONTRIBUTING, AND SUPPORT 🌸

See: https://github.com/so-dang-cool/sigi

👑 AUTHOR 👑

J.R. Hill https://so.dang.cool

sigi(1) · version 3.8.0 · June 23, 2026 — okay bye, go organize your stacks and relax, bestie! 🫶💅