Skip to content

Tools Creative Docs About

Menu

Tools
Creative
Docs
About

Frankie

Terminal code review assistant. Pulls pull-request comments into a keyboard-driven TUI with SQLite caching and background refresh.

Introduction

Prerequisites

Operation modes

Interactive mode (local discovery)

Discovery output
Disabling local discovery
Common discovery errors

Single pull request mode

Expected output

Repository listing mode

Listing output
Pagination
Rate limiting

AI rewrite mode

PR discussion summary mode

Library API: time-travel state

`load_time_travel_state`
`navigate_time_travel_state`

Review TUI mode

Keyboard shortcuts
Background sync
Codex execution from the TUI
Inline reply drafting
Filters
TUI display
Comment detail view
Full-screen diff context
Time-travel mode

Automated resolution verification

Verification requirements
CLI usage
TUI usage

Comment export mode

Export formats
Output destination
Stable ordering
Markdown format example

src/auth.rs:42

JSONL format example
Custom template format

{{ c.file }}:{{ c.line }} ({{ c.status }})

Export errors

Configuration

Configuration file
Environment variables
Command-line flags

Database migrations

Local caching

Error handling

Source

Source material

Contents

Introduction
- Introduction
Prerequisites
- Prerequisites
Operation modes
- Operation modes
Interactive mode (local discovery)
Single pull request mode
- Single pull request mode
- Expected output
Repository listing mode
AI rewrite mode
- AI rewrite mode
PR discussion summary mode
- PR discussion summary mode
Library API: time-travel state
Review TUI mode
Automated resolution verification
Comment export mode
src/auth.rs:42
{{ c.file }}:{{ c.line }} ({{ c.status }})
- {{ c.file }}:{{ c.line }} ({{ c.status }})
- Export errors
Configuration
Database migrations
- Database migrations
Local caching
- Local caching
Error handling
- Error handling

Introduction

Updated Jul 27, 2026

This guide explains how to use Frankie for GitHub pull request workflows, including loading individual pull requests and listing PRs for a repository.

df12 Productions

Serious systems, playful worlds. We ship tools that cut build times and stories that map the human edge of complex networks.

OSS & Licences

Limela — licence
Netsuke — licence
mxd — licence
Episodic — licence

Stay in touch

[email protected]
GitHub
Bluesky

Built for curious builders and storytellers everywhere. © 2026 df12 Productions.