Skip to content

PyModel/pythinker-code / .agents/skills/opentui

opentui

Verified

Build terminal UIs with OpenTUI. Covers core, components, audio, keymaps, React, Solid, plugins, testing, standalone executables, QR encoding, SSH, and Three.js WebGPU.

FileKindSize
SKILL.mdskill md5.4 KB
docs/bindings/react.mdxmarkdown11.0 KB
docs/bindings/solid.mdxmarkdown15.0 KB
docs/components/ascii-font.mdxmarkdown4.3 KB
docs/components/box.mdxmarkdown5.5 KB
docs/components/code.mdxmarkdown10.2 KB
docs/components/diff.mdxmarkdown4.2 KB
docs/components/frame-buffer.mdxmarkdown6.7 KB
docs/components/input.mdxmarkdown5.6 KB
docs/components/line-number.mdxmarkdown4.0 KB
docs/components/markdown.mdxmarkdown10.6 KB
docs/components/qr-code.mdxmarkdown4.3 KB
docs/components/scrollbar.mdxmarkdown2.3 KB
docs/components/scrollbox.mdxmarkdown7.5 KB
docs/components/select.mdxmarkdown6.2 KB
docs/components/slider.mdxmarkdown2.2 KB
docs/components/tab-select.mdxmarkdown6.0 KB
docs/components/text-table.mdxmarkdown9.0 KB
docs/components/text.mdxmarkdown4.5 KB
docs/components/textarea.mdxmarkdown7.7 KB
docs/components/time-to-first-draw.mdxmarkdown4.7 KB
docs/core-concepts/audio.mdxmarkdown32.2 KB
docs/core-concepts/colors.mdxmarkdown7.8 KB
docs/core-concepts/console.mdxmarkdown3.2 KB
docs/core-concepts/constructs.mdxmarkdown5.8 KB
docs/core-concepts/keyboard.mdxmarkdown10.4 KB
docs/core-concepts/layout.mdxmarkdown4.0 KB
docs/core-concepts/lifecycle.mdxmarkdown4.4 KB
docs/core-concepts/notifications.mdxmarkdown2.3 KB
docs/core-concepts/renderables-vs-constructs.mdxmarkdown4.5 KB
docs/core-concepts/renderables.mdxmarkdown9.9 KB
docs/core-concepts/renderer.mdxmarkdown30.9 KB
docs/core-concepts/testing.mdxmarkdown14.6 KB
docs/getting-started.mdxmarkdown3.2 KB
docs/keymap/addons.mdxmarkdown15.6 KB
docs/keymap/core.mdxmarkdown38.9 KB
docs/keymap/custom-addons.mdxmarkdown26.7 KB
docs/keymap/hosts.mdxmarkdown15.7 KB
docs/keymap/overview.mdxmarkdown18.1 KB
docs/keymap/react.mdxmarkdown4.9 KB
docs/keymap/solid.mdxmarkdown5.1 KB
docs/plugins/core.mdxmarkdown12.6 KB
docs/plugins/react.mdxmarkdown6.5 KB
docs/plugins/slots.mdxmarkdown12.7 KB
docs/plugins/solid.mdxmarkdown7.0 KB
docs/reference/color-matrix.mdxmarkdown3.8 KB
docs/reference/env-vars.mdxmarkdown6.5 KB
docs/reference/native-span-feed.mdxmarkdown6.0 KB
docs/reference/package-entrypoints.mdxmarkdown9.6 KB
docs/reference/qr-encoder.mdxmarkdown12.3 KB
docs/reference/ssh.mdxmarkdown14.8 KB
docs/reference/standalone-executables.mdxmarkdown7.1 KB
docs/reference/three.mdxmarkdown14.8 KB
docs/reference/tree-sitter.mdxmarkdown4.6 KB

docs/components/diff.mdx

View on GitHub
---
title: Diff
description: Unified or split diff viewer
order: 15
---

# Diff

Render unified or split diffs with syntax highlighting and optional line numbers.

## Basic usage

### Renderable API

```typescript
import { DiffRenderable, SyntaxStyle, RGBA, createCliRenderer } from "@opentui/core"

const renderer = await createCliRenderer()

const syntaxStyle = SyntaxStyle.fromStyles({
  default: { fg: RGBA.fromHex("#E6EDF3") },
  string: { fg: RGBA.fromHex("#A5D6FF") },
  keyword: { fg: RGBA.fromHex("#FF7B72"), bold: true },
})

const diff = new DiffRenderable(renderer, {
  id: "diff",
  width: "100%",
  height: 16,
  diff: `diff --git a/app.ts b/app.ts\nindex 1111111..2222222 100644\n--- a/app.ts\n+++ b/app.ts\n@@ -1,3 +1,3 @@\n-const a = 1\n+const a = 2\n`,
  view: "split",
  filetype: "typescript",
  syntaxStyle,
  showLineNumbers: true,
})

renderer.root.add(diff)
```

## Construct API

> Not available yet. Use `DiffRenderable` for now.

## Split view scroll sync

When `view: "split"` is active, you can link the vertical scroll of both panes. Scrolling one pane then moves the other:

```typescript
const diff = new DiffRenderable(renderer, {
  id: "diff",
  view: "split",
  syncScroll: true,
  diff: patch,
  syntaxStyle,
})

// Toggle at runtime
diff.syncScroll = false
```

Scroll sync is a no-op in the unified view.

## Properties

| Property              | Type                            | Default     | Description                           |
| --------------------- | ------------------------------- | ----------- | ------------------------------------- |
| `diff`                | `string`                        | `""`        | Unified diff string                   |
| `view`                | `"unified"` or `"split"`        | `"unified"` | Layout style                          |
| `syncScroll`          | `boolean`                       | `false`     | Link vertical scroll in split view    |
| `filetype`            | `string`                        | -           | Syntax highlighting language          |
| `fg`                  | `string` or `RGBA`              | -           | Base foreground for inner code panes  |
| `syntaxStyle`         | `SyntaxStyle`                   | -           | Syntax style for code                 |
| `wrapMode`            | `"word"`, `"char"`, or `"none"` | -           | Code wrapping mode                    |
| `conceal`             | `boolean`                       | `false`     | Conceal markup when highlighting      |
| `selectionBg`         | `string` or `RGBA`              | -           | Selection background in code panes    |
| `selectionFg`         | `string` or `RGBA`              | -           | Selection foreground in code panes    |
| `treeSitterClient`    | `TreeSitterClient`              | -           | Custom Tree-sitter client             |
| `showLineNumbers`     | `boolean`                       | `true`      | Show line numbers                     |
| `lineNumberFg`        | `string` or `RGBA`              | `#888888`   | Line number text color                |
| `lineNumberBg`        | `string` or `RGBA`              | transparent | Line number background                |
| `addedLineNumberBg`   | `string` or `RGBA`              | transparent | Line number background for added      |
| `removedLineNumberBg` | `string` or `RGBA`              | transparent | Line number background for removed    |
| `addedBg`             | `string` or `RGBA`              | `#1a4d1a`   | Background for added lines            |
| `removedBg`           | `string` or `RGBA`              | `#4d1a1a`   | Background for removed lines          |
| `contextBg`           | `string` or `RGBA`              | transparent | Background for context lines          |
| `addedContentBg`      | `string` or `RGBA`              | -           | Optional content background (added)   |
| `removedContentBg`    | `string` or `RGBA`              | -           | Optional content background (removed) |
| `contextContentBg`    | `string` or `RGBA`              | -           | Optional content background (context) |
| `addedSignColor`      | `string` or `RGBA`              | `#22c55e`   | Sign color for added lines            |
| `removedSignColor`    | `string` or `RGBA`              | `#ef4444`   | Sign color for removed lines          |
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall