Share, list, archive, remove

Needs gander signup. These commands are hidden from gander --help until a token is saved.

These commands manage files on gander.md. They need signup. Use share when you want a URL without a live watch, list to see what is up, archive to hide a share without deleting it, and remove to 404 a link for good.

gander share plan.md
gander list
gander archive plan.md
gander remove plan.md

gander share plan.md uploads once and opens the short link. Later edits to the file do not move until you share again or switch to watch.

You can also share from the dashboard (Share a Markdown file). That creates the same kind of share. The browser does not know the file's absolute path, so ~/.gander/config.json does not record it yet. The next gander share plan.md or gander watch plan.md of that file keeps the existing short link and writes the path map, instead of creating a second share.

gander share plan.md --watch is the same as hosted watch. gander share --watch ~/reports is the directory form: new matching .md files are shared automatically and do not open a browser. Prefer the watch subcommand when that is what you mean.

Shares can have labels (up to 10). Repeat --label to set the set; --no-labels clears it. Omit both on a later share or watch to leave labels alone. A watch loop that always sent labels: [] would wipe dashboard edits. On first create (or when adopting a path onto an unlabeled dashboard share), if you omit --label, gander may attach one project label from the git toplevel or from a Workspace / Projects path segment. That is an ordinary label: remove it from the dashboard ⋮ menu or with --no-labels. gander list prints a LABELS column. Filter My Shares with /dashboard?label=gandermd.

Share flags

gander share plan.md --silent
gander share plan.md --private
gander share plan.md --visibility=anyone
gander share plan.md --visibility=private
gander share plan.md --visibility=hidden
gander share plan.md --comments anyone
gander share plan.md --comments private
gander share plan.md --comments disabled
gander share plan.md --no-comments
gander share plan.md --watch
gander share plan.md --label review --label agent
gander share plan.md --no-labels

--silent uploads (or refreshes) and prints the URL; it does not open a browser. That is not --visibility=hidden: the share still appears on My Shares and GET /s/{id} still serves at the share's visibility. Files adopted by a directory watch never open a browser, with or without --silent.

--private is a shortcut for --visibility=private (author and invited team). --no-comments is a shortcut for --comments disabled. Defaults on first create: visibility anyone, commenting private. You can set those first-create defaults in ~/.gander/config.json. On later uploads of the same file, omit a flag to leave that policy alone. Flags and the dashboard still win on an existing share. Details: Visibility.

List

gander list

Prints a table of your shares, including ARCHIVED, COMMENTING, VISIBILITY, LABELS, unresolved thread counts, and whether the file is currently watched. An archived share shows ARCHIVED yes, WATCH no, VISIBILITY hidden, and COMMENTING disabled. Use it when you forgot a short id, or before an invite --share.

Archive

Archiving hides the link and turns commenting off. The share leaves My Shares and every teammate's Shared with me. The file on disk is not touched. A live watch registered on that file stops. A directory watch keeps running and drops that one file. Sharing the file again puts the share back with the visibility and commenting it had before, unless that command sets them. The same action is on the dashboard.

gander archive plan.md
gander archive xK7m2pQa
gander archive https://gander.md/s/xK7m2pQa
gander archive --pick xK7m2pQa plan.md
gander archive --all plan.md
gander archive --yes plan.md
gander archive --non-interactive plan.md

You can identify a share by local path, short id, or full URL. Several filename matches use the same --pick, --all, and non-interactive rules as remove. --all archives every match of that argument. It does not archive every share in the account. The local path map keeps the file, so a later gander share plan.md still addresses this short id.

Remove

Removing 404s the public URL. The file on disk is not touched.

gander remove plan.md
gander remove xK7m2pQa
gander remove https://gander.md/s/xK7m2pQa
gander remove --all
gander remove --pick xK7m2pQa
gander remove --yes plan.md
gander remove --non-interactive plan.md

You can identify a share by local path, short id, or full URL. --all deletes every share in the account. --yes / --non-interactive skip the confirm prompt (needed in scripts). You can also delete one share from the dashboard.