tide

🌊 Tide - A Terminal Editor in Go

Tide is a modern, extensible terminal-based text editor written purely in Go. It features efficient syntax highlighting powered by Tree-sitter and is built with a focus on clean, modular code for stability and future growth.

✨ Features

• 🚀 Fast, Async Syntax Highlighting: Uses Tree-sitter for accurate, performant highlighting that updates dynamically via debounced, incremental parsing.
• 🎨 Theming Engine:
  • Load custom themes from TOML files in ~/.config/tide/themes/.
  • Set the active theme via ~/.config/tide/theme.toml.
  • Live theme switching with the :theme <name> command.
  • Supports True Color hex codes (#RRGGBB).
  • Includes a comfortable built-in default dark theme ("Dark comfort").
• 🌐 Multi-Language Support: Built-in support for Go, Python, JavaScript, JSON, and Rust. Easily extensible for more languages.
• ✏️ Core Editing:
  • Modal editing (Normal, Command, Find modes).
  • Text insertion, deletion, line handling.
  • Undo/Redo stack.
  • Yank (Copy) / Paste (Internal register or optional System Clipboard).
  • Find (/, n, N) with match highlighting.
  • Replace (:s/pattern/replacement/[g] on current line).
  • Auto Indentation.
  • Line numbering.
  • Configurable tab width rendering.
• ⚙️ Configuration:
  • Load settings (editor, logger) from ~/.config/tide/config.toml.
  • Command-line flag overrides for key settings.
  • Advanced, filterable logging system (slog based).
• 🧩 Modular & Extensible: Clean architecture with a basic plugin system (example: Word Count).

🚀 Getting Started

Installation

Ensure you have Go 1.21+ installed.

# Install latest release
go install github.com/bethropolis/tide/cmd/tide@latest

# Or, build from source:
# git clone https://github.com/bethropolis/tide.git
# cd tide
# go build ./cmd/tide/
# ./tide --help # See available flags

Make sure $GOPATH/bin (usually ~/go/bin) is in your system's $PATH.

Basic Usage

# Open a file
tide path/to/your/file.go

# Start with an empty buffer
tide

# Use flags to override config (see details below)
tide --loglevel debug --config config.toml main.rs

🔧 Configuration

Tide uses TOML files located in ~/.config/tide/.

# Example config.toml

[logger]
log_level = "info"           # "debug", "info", "warn", "error"
log_file_path = "tide.log"   # Path relative to CWD, absolute path, "" for default (~/.config/tide/tide.log), or "-" for stderr
# Filtering (optional - see logger docs/code for more):
# enabled_tags = ["core", "find"]
disabled_tags = ["theme", "highlight", "event"] # Hide noisy logs
# enabled_packages = ["app", "core"]
# disabled_packages = ["buffer"]

[editor]
tab_width = 4
scroll_off = 3
system_clipboard = false # Set true to use system clipboard
# status_bar_height = 1 # Currently fixed at 1

name = "My Custom Theme"
is_dark = true

[styles]
  Default = { fg = "#CDD6F4", bg = "#1E1E2E" } # Base background/foreground
  LineNumber = { fg = "#494D64", bg = "#1E1E2E" }
  StatusBar = { fg = "#CDD6F4", bg = "#181825" }
  StatusBarModified = { fg = "#F9E2AF" } # Inherits StatusBar BG
  Selection = { reverse = true }
  SearchHighlight = { fg = "#1E1E2E", bg = "#F9E2AF" }

  keyword = { fg = "#CBA6F7", bold = true }
  string = { fg = "#A6E3A1" }
  comment = { fg = "#6C7086", italic = true }
  # ... etc ...

⌨️ Keybindings (Default - Normal Mode)

📜 Commands (in Command Mode :)

🚧 Known Limitations / Future Plans

• Terminal Mouse Selection: Native terminal selection includes line numbers. Use internal Yank/Paste (Ctrl+X/Ctrl+V) for code. Full mouse support is planned.
• Undo for Global Replace/Complex Ops: Undo works for single changes but not yet reliably for global replaces or potentially some plugin actions.
• Limited Replace Scope: :s only operates on the current line. Range support (:%s, :'<,'>s) is planned.
• Basic Modes: Primarily Normal mode exists. no Insert/Visual modes are planned.
• Performance: Untested on very large files (> 100MB).
• Configuration: Limited configuration options currently. More planned (keybindings, etc.).
• Status Bar Styling: Segments like [Modified] aren't individually styled yet.

🤝 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.