pine

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 20 Open GitHub ↗

A native macOS code editor for CLI-agent workflows. Split editor and terminal panes, a cross-project Agent Inbox, private notifications, LSP, Git context — zero Electron.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![CI](https://github.com/batonogov/pine/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/batonogov/pine/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/batonogov/pine)](https://github.com/batonogov/pine/releases/latest)
[![Homebrew Cask](https://img.shields.io/badge/homebrew-pine--editor-orange)](https://github.com/batonogov/homebrew-tap)
[![License: MIT](https://img.shields.io/github/license/batonogov/pine)](https://github.com/batonogov/pine/blob/main/LICENSE)
[![macOS](https://img.shields.io/badge/macOS-26%2B-blue)](https://github.com/batonogov/pine)

> A native macOS code editor for CLI-agent workflows.

> **The agent stays in the terminal.**<br>
> **The code stays in view.**<br>
> **Pine brings them together.**

Pine reflects agent activity, file changes, diagnostics, and Git context across a fast native workspace without turning into another AI dashboard. Built with SwiftUI and AppKit for macOS 26 Liquid Glass — no Electron runtime.

## New in Pine 2.0

- **Cross-project Agent Inbox** keeps durable tasks together and routes back to the exact live session
- **Safer agent workflows** add isolated worktrees, task recovery, and evidence-based completion briefs
- **Useful signals without surveillance** provide actionable, privacy-bounded notifications and first-party CLI-agent adapters
- **A polished release experience** brings a branded DMG installer and Pine's new app icon

See the [Pine 2.0 release notes](https://github.com/batonogov/pine/releases/tag/v2.0.0) for the complete changelog.

## Features

- **Native macOS** — SwiftUI + AppKit, Liquid Glass UI, system text handling. No browser engine, no runtime
- **Agent-aware workflow** — Tracks durable tasks across projects in Agent Inbox, routes back to the exact live session, and sends privacy-bounded notifications for verified events or detected process exits
- **LSP code intelligence** — Diagnostics, completion, hover, go-to-definition, code actions, rename, and a Problems panel
- **Syntax highlighting** — bundled grammars for Swift, TypeScript, Python, Go, Rust, Java, Kotlin, Ruby, C/C++, and more
- **Split panes** — Drag tabs to edges to split horizontally or vertically. Drag between panes to move. Resize with divider
- **Built-in terminal** — Full VT100/xterm emulator via [SwiftTerm](https://github.com/migueldeicaza/SwiftTerm). Multiple tabs, themes, TUI apps, clickable file and OSC 8 links, send-to-terminal, pane maximize, and a global quick-terminal hotkey
- **Lightweight extensibility** — User grammars, tasks, and keybindings without an extension marketplace
- **Git integration** — File status in sidebar, diff markers in gutter, blame view, branch switching from title bar or Git menu
- **Symbol navigation** — Jump to functions and classes with Cmd+R
- **Code folding** — Fold/unfold blocks from the gutter or via menu
- **Minimap** — Scaled code overview with syntax colors and diff markers. Click to navigate
- **Find & replace** — In-file and project-wide search with .gitignore support
- **Quick Open** — Fuzzy file search with Cmd+P
- **Markdown preview** — Source, rendered, or side-by-side via [swift-markdown](https://github.com/swiftlang/swift-markdown)
- **Status bar** — Cursor position, line endings, indentation style, file size
- **Bracket matching** — Highlights matching pairs while skipping strings and comments
- **File management** — Reveal in Finder, duplicate files with Finder-like naming
- **Large file handling** — Progressive loading for 10 MB+ files, optional highlighting disable for 1 MB+
- **Strip trailing whitespace** — Automatically cleans up on save
- **Validation & format on save** — YAML, shell, Dockerfile, and Terraform diagnostics with language-aware formatters
- **Auto-save & session restore** — Picks up where you left off
- **Auto-updates** — Built-in via [Sparkle](https://sparkle-project.org)
- **Localized** — English, German, Spanish, French, Japanese, Korean, Portuguese (BR), Russian, Simplified Chinese

<details>
<summary>Screenshots</summary>

### Welcome Screen
<img src="assets/screenshot-welcome.png" width="600" alt="Pine Welcome Screen">

### Built-in Terminal
<img src="assets/screenshot-terminal.png" width="800" alt="Pine Terminal">

### Markdown Preview
<img src="assets/screenshot-markdown.png" width="800" alt="Pine Markdown Preview">

</details>

## Install

**Homebrew** (recommended):

```bash
brew install --cask batonogov/tap/pine-editor
```

**Direct download:** grab the latest `.dmg` from [Releases](https://github.com/batonogov/pine/releases/latest).

## Build from Source

Requires macOS 26+ and Xcode 26+.
Pine keeps a macOS 26.0 deployment target while also checking source compatibility with the current macOS 27 beta SDK.

```bash
git clone https://github.com/batonogov/pine.git
cd pine
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcodebuild -project Pine.xcodeproj -scheme Pine build
```

Dependencies resolve automatically via Swift Package Manager on first build.
See [DMG packaging](docs/dmg-packaging.md) to build and visually preview the
release disk image without publishing a release.

## Keyboard Shortcuts

| Shortcut | Action |
| --- | --- |
| `Cmd+P` | Quick Open |
| `Cmd+Shift+O` | Open folder |
| `Cmd+S` | Save |
| `Cmd+Option+S` | Save All |
| `Cmd+Shift+S` | Save As |
| `Cmd+Shift+D` | Duplicate file |
| `Cmd+W` | Close tab |
| `Cmd+F` | Find |
| `Cmd+Option+F` | Find & Replace |
| `Cmd+G` / `Cmd+Shift+G` | Find Next / Previous |
| `Cmd+E` | Use Selection for Find |
| `Cmd+L` | Go to Line |
| `Cmd+R` | Go to Symbol |
| `Cmd+/` | Toggle comment |
| `Cmd+Shift+B` | Switch branch |
| `Cmd+Shift+M` | Toggle minimap |
| `Cmd+Shift+P` | Markdown preview |
| `Ctrl+Option+Down` / `Up` | Next / Previous change |
| `` Cmd+` `` | Toggle terminal |
| `Cmd+T` | New terminal tab |
| `Cmd++` / `Cmd+-` | Zoom in / out |
| `Cmd+0` | Reset font size |

## Architecture

MVVM with SwiftUI views backed by AppKit via `NSViewRepresentable`. The editor core uses the native NSTextStorage/NSLayoutManager/NSTextContainer stack. Syntax highlighting runs asynchronously on a background queue with generation tokens to prevent stale results. Git operations run in parallel via GCD. Project-wide search uses Swift concurrency with sliding-window parallelism.

## Contributing

Contributions are welcome. Please open an issue first to discuss what you'd like to change. See the [Issues](https://github.com/batonogov/pine/issues) page.

## License

[MIT](LICENSE)

pine

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README