Beautiful terminal interfaces for Swift.

Chio means attractive or pretty in Singlish. Chio is an opinionated, declarative framework for polished terminal interfaces, built on SwiftTUI. Charm-inspired themes, searchable lists and checklists, form fields, file selection, maps, and Markdown compose with native SwiftTUI views. SwiftTUI handles rendering, layout, input, and focus.

▶ Watch Chio in action · Examples and controls

Chio is a personal project built with Codex assistance and human curation. Codex contributes to implementation, tests, and documentation, while the human maintainer guides the project's direction, design, and what to keep.

It is built primarily for personal use and shared for anyone who finds it useful. We cannot vouch for its stability or suitability for production use. APIs and behavior may change without notice. Automated tests cover specific workflows, not every terminal, platform, or integration; evaluate it for your own needs before relying on it.

import SwiftTUI
import Chio

struct AgentsView: View {
    let agents: [Agent] // Your Identifiable model, with a stable ID and name.
    @State private var selection: Agent.ID?

    var body: some View {
        GroupBox("Agents") {
            SearchableList(agents, selection: $selection, searchText: \.name) {
                Text($0.name)
            }
        }
        .style(.default)
    }
}

One immutable style gives descendants consistent colors, spacing, surfaces and focus styling. Start with .default, .light, .btop or .opencode, and customize with replacing(...). API usage and recipes →

Requires Swift 6.4+, on macOS 15+ or Linux. From a repository checkout:

swift run -c release chio-dashboard

Use arrows to navigate, / to filter, Enter to open a report, Ctrl-K for the command palette, and q to quit. Release mode gives better interactive performance. For true-color terminals over SSH, prefix the command with COLORTERM=truecolor.

Add --choices, --text-entry, --feedback, or --files to try a focused example. Try world and street maps with locations and routes:

swift run -c release chio-maps --map street
# Add --online to load neighboring OpenFreeMap tiles as you pan.

Example controls and launch options →

• Charm, especially Lip Gloss, Bubbles, Huh, and Glamour — cohesive themes, expressive controls, forms, and polished terminal typography.
• btop++ — compact panels, meters, history graphs, and information-dense layouts in the compact metrics example.
• OpenCode — restrained surfaces, accent edges and breathing room, explored in the appearance study.
• gh-dash — dense collections, contextual navigation, and list/detail workspaces.
• Hunk — readable diffs and keyboard-driven review flows; the reference for the example-only diff reader prototype.
• MapSCII — terminal cartography, explored in the map component.

Chio adapts these ideas to native SwiftTUI composition and Swift APIs.

• API usage — styles and component recipes
• Examples — controls, screenshots, and SSH guidance
• Design — architecture and interaction contracts
• Coverage · Plan · Development checks

Code: MIT License. Bundled map data retains its source licenses.