> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flumeirc.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Navigation

> Buffer, server, and content navigation commands

## /go

```
/go <name or number>
```

The quickest way to jump around. Accepts buffer numbers, exact names, or partial matches.

```
/go 3          # jump to window 3
/go #rust      # exact match
/go rust       # partial match — finds #rust
/go flu        # partial match — finds #flume
/go libera     # switch to a different server
/go flume      # switch to the global flume buffer
```

Buffer numbers are shown in the buffer list panel (e.g., `1.server`, `2.#rust`). Partial matching is case-insensitive and matches anywhere in the name.

## /buffer

```
/buffer [name]
```

With no args: list all buffers with their numbers and unread counts.

```
/buffer
  1: server
  2: #rust (3 unread) *
  3: #flume
```

With a name: switch to that buffer.

```
/buffer #rust     # switch to #rust
/buffer server    # switch to server buffer
```

## /switch

```
/switch <server>
```

Switch to a different connected server. Your buffer position within each server is remembered.

## /close

```
/close
```

Close the active buffer and switch to the previous one. Channels are also auto-closed when you `/part`.

## /clear

```
/clear
```

Clear the active buffer's message history. The buffer stays open.

## /search

```
/search [pattern]
```

Search the active buffer for a text pattern. All matching lines are highlighted with the `search_match_bg`/`search_match_fg` theme colors.

```
/search error      # highlight all lines containing "error"
/search            # clear search highlighting
```

Searching is case-insensitive. Use `/search` with no args to clear.

## /url

```
/url
/url <N>
/url open <N>
```

Manage URLs detected in the active buffer.

```
/url               # list last 10 URLs with nick attribution
/url 1             # open the most recent URL in your browser
/url open 3        # open the 3rd most recent URL
```

URLs are automatically detected in messages and rendered in the `chat_url` theme color with underline. The `/url` command lets you list and open them without scrolling.

The browser command is configurable:

```
/set general.url_open_command open       # macOS (default)
/set general.url_open_command xdg-open   # Linux (default)
```

## /emoji

```
/emoji [search]
```

Search emoji shortcodes or show usage info.

```
/emoji             # show usage and common examples
/emoji fire        # search: shows 🔥 :fire:
/emoji heart       # search: shows all heart variants
```

**Using emoji in messages:** Type `:shortcode:` and it's replaced with the emoji when you send:

```
:thumbsup: → 👍    :fire: → 🔥    :wave: → 👋
:heart: → ❤️       :rocket: → 🚀   :100: → 💯
:tada: → 🎉       :coffee: → ☕   :crab: → 🦀
```

**Tab completion:** Type `:thu` then press Tab to cycle through matches (`:thumbsup:` → 👍, `:thumbsdown:` → 👎). Works alongside nick completion — emoji triggers when the word starts with `:`.

160+ shortcodes available covering smileys, gestures, hearts, symbols, tech, food, nature, animals, celebrations, and flags.

## /help

```
/help [command]
```

With no args: show the full categorized command list.

With a command name: show detailed help for that specific command.

```
/help              # full command list
/help go           # help on /go
/help set          # help on /set with all settings
/help server       # help on /server with auth examples
/help split        # help on split views
/help generate     # help on AI generation
/help theme        # help on themes with path info
```

Also shows help text for script-registered commands — scripts provide help via `flume.command.register(name, fn, "help text")`.