<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="repartee — A modern terminal IRC client built with Ratatui, Tokio, and Rust. Scripting, theming, encrypted logging, and more.">
<meta name="keywords" content="irc, terminal, tui, client, chat, repartee, ratatui, tokio, rust">
<meta name="author" content="outragedevs">
<meta property="og:title" content="FAQ — repartee">
<meta property="og:description" content="A modern terminal IRC client built with Ratatui, Tokio, and Rust. Inspired by irssi, designed for the future.">
<meta property="og:type" content="website">
<meta property="og:url" content="https://outragedevs.github.io/repartee/">
<meta property="og:image" content="https://outragedevs.github.io/repartee/images/chat.png">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="{{title}} — repartee">
<meta name="twitter:description" content="A modern terminal IRC client built with Ratatui, Tokio, and Rust.">
<meta name="twitter:image" content="https://outragedevs.github.io/repartee/images/chat.png">
<title>{{title}} — repartee</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<button class="hamburger" aria-label="Toggle navigation">
<span></span>
<span></span>
<span></span>
</button>
<div class="page-wrapper">
<aside class="sidebar">
<div class="sidebar-header">
<a href="index.html" class="brand">repartee</a>
<span class="brand-tagline">Documentation</span>
</div>
<nav class="sidebar-nav">
<ul>
<li><a href="index.html">Home</a></li>
</ul>
<div class="nav-section">
<span class="nav-section-title">Getting Started</span>
<ul>
<li><a href="installation.html">Installation</a></li>
<li><a href="first-connection.html">First Connection</a></li>
<li><a href="configuration.html">Configuration</a></li>
</ul>
</div>
<div class="nav-section">
<span class="nav-section-title">Reference</span>
<ul>
<li><a href="commands.html">Commands</a></li>
</ul>
</div>
<div class="nav-section">
<span class="nav-section-title">Scripting</span>
<ul>
<li><a href="scripting-getting-started.html">Getting Started</a></li>
<li><a href="scripting-api.html">API Reference</a></li>
<li><a href="scripting-examples.html">Examples</a></li>
</ul>
</div>
<div class="nav-section">
<span class="nav-section-title">Customization</span>
<ul>
<li><a href="theming.html">Theming</a></li>
<li><a href="theming-format-strings.html">Format Strings</a></li>
<li><a href="logging.html">Logging & Search</a></li>
</ul>
</div>
<div class="nav-section">
<span class="nav-section-title">Usage</span>
<ul>
<li><a href="web-frontend.html">Web Frontend</a></li>
<li><a href="sessions.html">Sessions & Detach</a></li>
</ul>
</div>
<div class="nav-section">
<span class="nav-section-title">Project</span>
<ul>
<li><a href="architecture.html">Architecture</a></li>
<li><a href="faq.html" class="active">FAQ</a></li>
</ul>
</div>
</nav>
<div class="sidebar-footer">
Built with <a href="https://www.rust-lang.org">Rust</a>
·
<a href="https://github.com/outragedevs/repartee">GitHub</a>
</div>
</aside>
<div class="sidebar-overlay"></div>
<div class="content-wrapper">
<main class="content">
<h1>FAQ</h1>
<h2>What is repartee?</h2>
<p>repartee is a terminal IRC client written in Rust, inspired by irssi and built as a port of <a href="https://github.com/kofany/kokoIRC">kokoirc</a> (TypeScript/OpenTUI/Bun) to Rust/ratatui/tokio.</p>
<h2>Why Rust?</h2>
<ul>
<li><strong>Performance</strong>: ~5MB binary, instant startup, minimal memory usage</li>
<li><strong>Safety</strong>: Memory-safe without garbage collection</li>
<li><strong>Concurrency</strong>: tokio async runtime handles multiple connections efficiently</li>
<li><strong>Reliability</strong>: Rust's type system catches bugs at compile time</li>
<li><strong>Distribution</strong>: Single static binary, no runtime dependencies</li>
</ul>
<h2>How does repartee compare to kokoirc?</h2>
<table>
<thead>
<tr>
<th>Feature</th>
<th>kokoirc</th>
<th>repartee</th>
</tr>
</thead>
<tbody><tr>
<td>Language</td>
<td>TypeScript</td>
<td>Rust</td>
</tr>
<tr>
<td>TUI framework</td>
<td>OpenTUI/React</td>
<td>ratatui</td>
</tr>
<tr>
<td>Runtime</td>
<td>Bun</td>
<td>Native binary</td>
</tr>
<tr>
<td>Binary size</td>
<td>~68MB</td>
<td>~5MB</td>
</tr>
<tr>
<td>Scripting</td>
<td>TypeScript</td>
<td>Lua 5.4</td>
</tr>
<tr>
<td>Config format</td>
<td>TOML</td>
<td>TOML (same format)</td>
</tr>
<tr>
<td>Theme format</td>
<td>irssi-compatible</td>
<td>irssi-compatible (same)</td>
</tr>
</tbody></table>
<p>The config and theme formats are compatible — you can copy your kokoirc config to repartee with minimal changes.</p>
<h2>How do I migrate from kokoirc?</h2>
<ol>
<li>Copy <code>~/.kokoirc/config.toml</code> to <code>~/.repartee/config.toml</code></li>
<li>Copy <code>~/.kokoirc/.env</code> to <code>~/.repartee/.env</code></li>
<li>Copy <code>~/.kokoirc/themes/</code> to <code>~/.repartee/themes/</code></li>
<li>Scripts need to be rewritten from TypeScript to Lua</li>
</ol>
<h2>How do I migrate from irssi?</h2>
<p>repartee uses irssi-compatible format strings, so your theme knowledge transfers directly. The key differences:</p>
<ul>
<li>Config is TOML instead of irssi's custom format</li>
<li>Scripts are Lua instead of Perl</li>
<li>Most <code>/commands</code> work the same</li>
</ul>
<h2>Does repartee support DCC?</h2>
<p>Yes — repartee supports DCC CHAT with full irssi/erssi parity:</p>
<ul>
<li><strong>Active and passive</strong> (reverse) DCC CHAT connections</li>
<li><strong><code>=nick</code> buffer convention</strong> — DCC chats appear as <code>=Alice</code> in the buffer list</li>
<li><strong>Auto IP detection</strong> from the IRC socket, with manual override via <code>/set dcc.own_ip</code></li>
<li><strong>Auto-accept masks</strong>, timeout, nick tracking, DCC REJECT</li>
<li><strong>Tab-completable commands</strong>: <code>/dcc chat</code>, <code>/dcc close</code>, <code>/dcc list</code>, <code>/dcc reject</code></li>
<li><strong>Scripting events</strong>: <code>dcc.chat.request</code>, <code>dcc.chat.connected</code>, <code>dcc.chat.message</code>, <code>dcc.chat.closed</code></li>
</ul>
<h2>Does repartee load chat history?</h2>
<p>Yes. When you open a channel, query, or DCC buffer, the last 20 messages (configurable) are loaded from the SQLite log database. Set <code>display.backlog_lines</code> to adjust or disable.</p>
<h2>Where are logs stored?</h2>
<p><code>~/.repartee/logs/messages.db</code> — a SQLite database with optional AES-256-GCM encryption.</p>
<h2>Can I use multiple IRC networks?</h2>
<p>Yes. Add multiple <code>[servers.*]</code> sections to your config. Each gets its own connection and set of channel buffers.</p>
<h2>Does repartee support IRCv3?</h2>
<p>Yes — repartee has comprehensive IRCv3 support negotiated at connection time:</p>
<ul>
<li><strong>server-time</strong>, <strong>echo-message</strong>, <strong>away-notify</strong>, <strong>account-notify</strong>, <strong>chghost</strong>, <strong>cap-notify</strong></li>
<li><strong>multi-prefix</strong> (e.g. <code>@+nick</code>), <strong>extended-join</strong>, <strong>userhost-in-names</strong>, <strong>message-tags</strong></li>
<li><strong>invite-notify</strong>, <strong>BATCH</strong> (netsplit/netjoin grouping)</li>
<li><strong>SASL</strong>: PLAIN, EXTERNAL (client certificate), SCRAM-SHA-256</li>
<li><strong>WHOX</strong>: auto-detected for account name and full host tracking</li>
<li><strong>Extban</strong>: <code>$a:account</code> ban type with <code>/ban -a</code> shorthand</li>
</ul>
<h2>How do I keep repartee running in the background?</h2>
<p>Use <code>/detach</code> (or press <code>Ctrl+\</code> / <code>Ctrl+Z</code>) to detach from the terminal. repartee continues running — IRC connections stay alive, messages are logged, and scripts keep executing.</p>
<p>Reattach with <code>repartee a</code> from any terminal. You can also start headless with <code>repartee -d</code> and attach later.</p>
<p>See <a href="sessions.html">Sessions & Detach</a> for the full guide.</p>
<h2>Can I close my terminal and reconnect later?</h2>
<p>Yes. When you close your terminal window, repartee catches SIGHUP and auto-detaches. The session stays running and you can reattach with <code>repartee a</code>.</p>
<p>This also works across SSH disconnections — start with <code>repartee -d</code> on a remote server, disconnect SSH, reconnect later, and <code>repartee a</code> picks up your session.</p>
<h2>What does /cycle do?</h2>
<p><code>/cycle</code> parts and immediately rejoins a channel. Useful for refreshing your nick list, re-triggering auto-op, or clearing stale channel state. Channel keys are preserved. Alias: <code>/rejoin</code>.</p>
<h2>How do I report bugs?</h2>
<p>Open an issue on the <a href="https://github.com/outragedevs/repartee/issues">GitHub repository</a>.</p>
<nav class="page-nav">
<a href="architecture.html" class="page-nav-link prev">
<span class="page-nav-label">← Previous</span>
<span class="page-nav-title">Architecture</span>
</a>
</nav>
<footer class="site-footer">
Built with <a href="https://www.rust-lang.org">Rust</a> ·
<a href="https://github.com/outragedevs/repartee">GitHub</a> ·
MIT License
</footer>
</main>
</div>
</div>
<script>
(function() {
const hamburger = document.querySelector('.hamburger');
const sidebar = document.querySelector('.sidebar');
const overlay = document.querySelector('.sidebar-overlay');
function toggleSidebar() {
hamburger.classList.toggle('active');
sidebar.classList.toggle('open');
overlay.classList.toggle('visible');
document.body.style.overflow = sidebar.classList.contains('open') ? 'hidden' : '';
}
function closeSidebar() {
hamburger.classList.remove('active');
sidebar.classList.remove('open');
overlay.classList.remove('visible');
document.body.style.overflow = '';
}
hamburger.addEventListener('click', toggleSidebar);
overlay.addEventListener('click', closeSidebar);
document.addEventListener('keydown', function(e) {
if (e.key === 'Escape' && sidebar.classList.contains('open')) {
closeSidebar();
}
});
})();
</script>
</body>
</html>