KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

vimcord

★ 16 Open GitHub ↗

A Terminal UI Discord Client in Rust

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# vimcord - Terminal UI Discord client

![Chat Example](https://raw.githubusercontent.com/YetAnotherMechanicusEnjoyer/vimcord/main/readme/example.png)

## About

vimcord is a terminal UI Discord client written in Rust.

For best visuals, install  [NerdFonts](https://www.nerdfonts.com/)

### Terms of Service Notice

> [!WARNING]
> Under no circumstances should you use a Discord User Token (also known as a self-bot token) with this software or any associated tools.

Discord's [Terms of Service (ToS)](https://discord.com/terms) explicitly prohibits the use of User Tokens for programmatic access or self-botting. Violation of these terms can lead to permanent termination of your Discord account.

> **Do not use self-bots or user-bots.** Each account must be associated with a human, not a bot. Self-bots put strain on Discord’s infrastructure and our ability to run our services. For more information, you can read our Developer Policies [here](https://discord.com/developers/docs/policy).

The developers, contibutors, and maintainers are not responsible for any consequences resulting from a user's violation of Discord's Terms of Service. You (the user) assumes all risk if you choose to ignore Discord's policies.

## Installation

### Arch Linux ([AUR](https://aur.archlinux.org/packages/vimcord))

Requires [YaY](https://github.com/Jguer/yay)

```bash
yay -S vimcord
# or
yay -S vimcord-git
```

### Binaries

Download prebuilt binaries from: [releases](https://github.com/YetAnotherMechanicusEnjoyer/vimcord/releases/)

### [Cargo](https://doc.rust-lang.org/cargo/)

Requires [Rust](https://www.rust-lang.org/tools/install)

Make sure that `~/.cargo/bin` is in your PATH env variable.

#### With [crates.io](https://crates.io/crates/vimcord)

```bash
cargo install vimcord
```

### From Source

```bash
git clone https://github.com/YetAnotherMechanicusEnjoyer/vimcord
cd vimcord/
cargo build --release
```

Run:

```bash
./target/release/vimcord
```

## Configuration
Set your Discord token **on the first launch only** using one of the following:

### Shell
```bash
export DISCORD_TOKEN="your-token-here"
```

### Inline
```bash
DISCORD_TOKEN="your-token-here" vimcord
```

## Usage

```bash
vimcord
```

## Keybinds

For a detailed list of all standard and Vim-mode keybinds, please see the [Keybinds Documentation](readme/keybinds.md).

## Commands

For a list of supported Vim-mode commands (e.g., `:quit`), please see the [Commands Documentation](readme/commands.md).

## Roadmap & Missing Features

While `vimcord` is fully functional for basic chat and navigation, there are many exciting features on our radar!

To see our future plans, feature backlog, and what still needs to be implemented (such as mentions, threaded conversations, and reactions), please take a look at our [Roadmap & Feature Backlog](readme/todo.md). We have carefully detailed and categorized upcoming features by priority and difficulty to help guide development and encourage community contributions. We'd love your help in making this the best terminal Discord client possible!

## Licence

[![MIT](https://img.shields.io/github/license/YetAnotherMechanicusEnjoyer/vimcord?style=for-the-badge&logo=github&color=2EA44F)](https://github.com/YetAnotherMechanicusEnjoyer/vimcord/blob/5392a5b9f8982187b02d11ccd94dcd952fee36b6/LICENSE)

vimcord

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README