github.com/ghostty-org/ghostty (link)

commit signals (120)

source signals (13)

• src/terminal/snapshot/AGENTS.mdvia agents-md

  # Terminal Binary Snapshot
  
  - Apply the robustness principle: "be conservative in what you do, be liberal
    in what you accept from others."
    - Validate on encode
    - Gracefully degrade on decode, for example invalid styles degrade to
      ignoring the style.
  

• src/inspector/AGENTS.mdvia agents-md

  # Inspector Subsystem
  
  The inspector is a feature of Ghostty that works similar to a
  browser's developer tools. It allows the user to inspect and modify the
  terminal state.
  
  - See the full C API by finding `dcimgui.h` in the `.zig-cache` folder
    in the root: `find . -type f -name dcimgui.h`. Use the newest version.
  - See full examples of how to use every widget by loading this file:
    <https://raw.githubusercontent.com/ocornut/imgui/refs/heads/master/imgui_demo.cpp>
  - On macOS, run builds with `-Demit-maco

• src/terminal/compress/AGENTS.mdvia agents-md

  # Terminal Compression
  
  Guidance for the codecs and the compressed page representation
  (`Page.zig`) in this directory. These compress terminal page backing
  memory (`terminal.Page`).
  
  ## Priorities
  
  When making tradeoffs, in order:
  
  1. **Compression ratio on page-shaped data.** Encoded bytes are retained
     scrollback memory, and raw `terminal.Page` backing memory is the only
     thing we actually compress. Ratio on text files or synthetic data is a
     secondary signal.
  2. **Decompression throughput.** Pages 

• test/fuzz-libghostty/AGENTS.mdvia agents-md

  # AFL++ Fuzzer for Libghostty
  
  - Build all fuzzer with `zig build`
  - The list of available fuzzers is in `build.zig` (search for `fuzzers`).
  - Run a specific fuzzer with `zig build run-<name>` (e.g. `zig build run-parser`)
  - Corpus directories follow the naming convention `corpus/<fuzzer>-<variant>`
    (e.g. `corpus/parser-initial`, `corpus/stream-cmin`).
  - Do NOT run `afl-tmin` unless explicitly requested — it is very slow.
  - After running `afl-cmin`, run `corpus/sanitize-filenames.sh`
    before committing

• macos/AGENTS.mdvia agents-md

  # macOS Ghostty Application
  
  - Use `swiftlint` for formatting and linting Swift code.
  - If code outside of `macos/` directory is modified, use
    `zig build -Demit-macos-app=false` before building the macOS app to update
    the underlying Ghostty library.
  - Use `macos/build.nu` to build the macOS app, do not use `zig build`
    (except to build the underlying library as mentioned above).
    - Build: `macos/build.nu [--scheme Ghostty] [--configuration Debug] [--action build]`
    - Output: `macos/build/<configurati

• AGENTS.mdvia agents-md

  # Agent Development Guide
  
  A file for [guiding coding agents](https://agents.md/).
  
  ## Commands
  
  - **Build:** `zig build`
    - If you're on macOS and don't need to build the macOS app, use
      `-Demit-macos-app=false` to skip building the app bundle and speed up
      compilation.
  - **Test (Zig):** `zig build test`
    - Prefer to run targeted tests with `-Dtest-filter` because the full
      test suite is slow to run.
  - **Test filter (Zig)**: `zig build test -Dtest-filter=<test name>`
  - **Formatting (Zig)**: `zig

• example/AGENTS.mdvia agents-md

  # Example Libghostty Projects
  
  Each example is a standalone project with its own `build.zig`,
  `build.zig.zon`, `README.md`, and `src/main.c` (or `.zig`). Examples are
  auto-discovered by CI via `example/*/build.zig.zon`, so no workflow file
  edits are needed when adding a new example.
  
  ## Adding a New Example
  
  1. Copy an existing example directory (e.g., `c-vt-encode-focus/`) as a
     starting point.
  2. Update `build.zig.zon`: change `.name`, generate a **new unique**
     `.fingerprint` value (a random `u64` he

• src/terminal/c/AGENTS.mdvia agents-md

  # libghostty-vt C API
  
  - C API must be designed with ABI compatibility in mind
  - Zig tagged unions must be converted to C ABI compatible unions
    via `lib.TaggedUnion`.
  - Any functions must be updated all the way through from here to
    `src/terminal/c/main.zig` to `src/lib_vt.zig` and the headers
    in `include/ghostty/vt.h`. Specifically:
    1. Define the function in `src/terminal/c/<module>.zig`.
    2. Re-export it via a `pub const` in `src/terminal/c/main.zig`.
    3. Add an `@export` call in `src/lib_vt.zig`

• src/terminal/apc/glyph/AGENTS.mdvia agents-md

  # Glyph Protocol
  
  - The specification source of truth is:
    <https://github.com/raphamorim/rio/blob/main/specs/glyph-protocol.md>
  - A summary of the specification is available in
    `src/terminal/apc/glyph.zig` at the top.
  - Reference the specification whenever any changes are made to
    this folder. Prefer the local specification over fetching the
    latest, unless it is lacking information.
  

• src/benchmark/AGENTS.mdvia agents-md

  # Benchmarking
  
  The benchmark tools are split into two roles:
  
  - `ghostty-gen` generates synthetic input data.
  - `ghostty-bench` consumes existing input data and runs a benchmark.
  
  ## Workflow
  
  - For timing comparisons, generate data first and benchmark it later.
  - Do not pipe `ghostty-gen` directly into `ghostty-bench` when comparing
    performance. That mixes generation cost into the measurement and makes
    branch-to-branch comparisons noisy.
  - Reuse the exact same generated files when comparing revisions.

• .agents/skills/writing-commit-messages/SKILL.mdvia unspecified

  ---
  name: writing-commit-messages
  description: >-
    Writes Git commit messages. Activates when the user asks to write
    a commit message, draft a commit message, or similar.
  ---
  
  # Writing Commit Messages
  
  Write commit messages that follow commit style guidelines for the project.
  
  ## Format
  
  ```
  <subsystem>: <summary>
  
  <reference issues/PRs/etc.>
  
  <long form description>
  ```
  
  ## Rules
  
  ### Subject line
  
  - **Subsystem prefix**: Use a short, lowercase identifier for the
    area of code changed (e.g., `terminal

• .agentsdirectoryvia unspecified
• .agentsdirectoryvia unspecified

ignorefile signals (0)

none