echoes 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c05df4a1ad800e1b7e982aa2577a2bd6c64bfe15ec4c630aff8a561b53992072
+  data.tar.gz: dc78e9e8813c237375818a76e87b3a756cf9431e0dfb78da331cb5e8b309ca5a
+SHA512:
+  metadata.gz: 8fd75f4eff8db332e59669df7359c0a0a904d9b879da99dcd33aa4dfb053a28869f80e556b9f783c6e362b8b34397ffab264d59a0aeda9c76244ad639d187dfa
+  data.tar.gz: 53a1aa9d6ee94264a31fb68c9f94ff5289415540e48461031a9b91cf52b31f8706bd9fce89dee880b2d1546c94b25605c4955545fefa0475b5aeb4c2908b8920

data/CLAUDE.md

@@ -0,0 +1,33 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Echoes is a Ruby gem (currently a freshly scaffolded template at v0.1.0). Author: Akira Matsuda. Requires Ruby >= 3.2.0. Licensed under MIT.
+
+## Commands
+
+- **Install dependencies:** `bin/setup`
+- **Run all tests:** `bundle exec rake test` (or just `bundle exec rake`, test is the default task)
+- **Run a single test file:** `bundle exec ruby -Ilib:test test/echoes_test.rb`
+- **Run a single test method:** `bundle exec ruby -Ilib:test test/echoes_test.rb -n test_method_name`
+- **Interactive console:** `bin/console`
+- **Install gem locally:** `bundle exec rake install`
+
+## Architecture
+
+Standard Ruby gem layout:
+
+- `lib/echoes.rb` — Main module entry point (defines `Echoes` module)
+- `lib/echoes/version.rb` — Version constant
+- `sig/echoes.rbs` — RBS type signatures
+- `test/` — Tests using **test-unit** framework (not minitest, not rspec)
+
+## Testing
+
+Uses the **test-unit** gem (~> 3.0). Test classes inherit from `Test::Unit::TestCase`. Test helper is at `test/test_helper.rb`.
+
+## CI
+
+GitHub Actions runs `bundle exec rake` on push to master and on pull requests (Ruby 4.1.0, ubuntu-latest).

data/Echoes.app/Contents/Info.plist

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>Echoes</string>
+  <key>CFBundleIdentifier</key>
+  <string>com.github.amatsuda.echoes</string>
+  <key>CFBundleVersion</key>
+  <string>0.2.0</string>
+  <key>CFBundleExecutable</key>
+  <string>Echoes</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+</dict>
+</plist>

data/Echoes.app/Contents/MacOS/Echoes

@@ -0,0 +1,50 @@
+#!/bin/bash
+# LaunchServices may pick the x86_64 slice of /bin/bash when launching
+# this script-based .app bundle (script-based bundles don't get the
+# Get Info "Open using Rosetta" toggle, but they're not necessarily
+# launched native either). If bash runs translated, Ruby and every
+# child rubish forks downstream — including brew — inherits the
+# translated arch and may bail with "Cannot install under Rosetta 2".
+# Force native arch on Apple Silicon to break that inheritance.
+
+set -e
+
+# Derive ECHOES_ROOT from the script's own location so the .app works
+# inside any clone of the repo regardless of homedir or path. The
+# script lives at <repo>/Echoes.app/Contents/MacOS/Echoes, so root
+# is three levels up.
+SCRIPT="${BASH_SOURCE[0]}"
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT")" && pwd)"
+ECHOES_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+ECHOES_LIB="$ECHOES_ROOT/lib"
+ECHOES_BIN="$ECHOES_ROOT/exe/echoes"
+
+# Pick a Ruby interpreter. Honor an explicit override via $RUBY,
+# otherwise probe common locations (rbenv, homebrew, system) and
+# fall back to whatever `env ruby` finds. Echoes requires Ruby
+# >= 3.2; the first match wins, so adjust your PATH or set $RUBY
+# if you need a specific version.
+if [ -z "${RUBY:-}" ]; then
+  for cand in \
+    "$HOME/.rbenv/shims/ruby" \
+    /opt/homebrew/bin/ruby \
+    /usr/local/bin/ruby \
+    /usr/bin/ruby
+  do
+    if [ -x "$cand" ]; then
+      RUBY="$cand"
+      break
+    fi
+  done
+fi
+RUBY="${RUBY:-$(command -v ruby || true)}"
+if [ -z "$RUBY" ] || [ ! -x "$RUBY" ]; then
+  echo "Echoes: no Ruby interpreter found. Set \$RUBY or install one." >&2
+  exit 127
+fi
+
+if [ "$(/usr/sbin/sysctl -in hw.optional.arm64)" = "1" ]; then
+  exec /usr/bin/arch -arm64 "$RUBY" -I"$ECHOES_LIB" "$ECHOES_BIN"
+else
+  exec "$RUBY" -I"$ECHOES_LIB" "$ECHOES_BIN"
+fi

data/EchoesEmbed.app/Contents/Info.plist

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>EchoesEmbed</string>
+  <key>CFBundleIdentifier</key>
+  <string>com.github.amatsuda.echoes-embed</string>
+  <key>CFBundleVersion</key>
+  <string>0.2.0</string>
+  <key>CFBundleExecutable</key>
+  <string>EchoesEmbed</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+</dict>
+</plist>

data/EchoesEmbed.app/Contents/MacOS/EchoesEmbed

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Same as Echoes.app's launcher, but exports ECHOES_EMBED=1 so panes
+# come up running rubish in-process via the per-pane helper instead
+# of the legacy PTY-spawn-a-shell mode. See Echoes.app's launcher for
+# why we force native arch on Apple Silicon and how the paths /
+# Ruby interpreter are resolved.
+
+set -e
+
+SCRIPT="${BASH_SOURCE[0]}"
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT")" && pwd)"
+ECHOES_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd)"
+ECHOES_LIB="$ECHOES_ROOT/lib"
+ECHOES_BIN="$ECHOES_ROOT/exe/echoes"
+
+if [ -z "${RUBY:-}" ]; then
+  for cand in \
+    "$HOME/.rbenv/shims/ruby" \
+    /opt/homebrew/bin/ruby \
+    /usr/local/bin/ruby \
+    /usr/bin/ruby
+  do
+    if [ -x "$cand" ]; then
+      RUBY="$cand"
+      break
+    fi
+  done
+fi
+RUBY="${RUBY:-$(command -v ruby || true)}"
+if [ -z "$RUBY" ] || [ ! -x "$RUBY" ]; then
+  echo "Echoes: no Ruby interpreter found. Set \$RUBY or install one." >&2
+  exit 127
+fi
+
+export ECHOES_EMBED=1
+
+if [ "$(/usr/sbin/sysctl -in hw.optional.arm64)" = "1" ]; then
+  exec /usr/bin/arch -arm64 "$RUBY" -I"$ECHOES_LIB" "$ECHOES_BIN"
+else
+  exec "$RUBY" -I"$ECHOES_LIB" "$ECHOES_BIN"
+fi

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Akira Matsuda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,133 @@
+# Echoes
+
+A pure-Ruby AppKit-based macOS terminal emulator. Echoes aims to be a
+well-integrated host for Ruby tooling — embedding [rubish] (a Ruby
+shell) and [rvim] (a Ruby vim) as first-class panes, with native
+prompt rendering, structured completions, and a private OSC namespace
+that lets in-pane Ruby tools drive UI features (gradient backgrounds,
+proportional fonts) other terminals can't.
+
+[rubish]: https://github.com/amatsuda/rubish
+[rvim]:   https://github.com/amatsuda/rvim
+
+## Requirements
+
+- macOS (uses AppKit via Fiddle; no Linux/Windows support)
+- Ruby >= 3.2
+
+## Installation
+
+```sh
+gem install echoes
+echoes install
+```
+
+`echoes install` drops thin `Echoes.app` and `EchoesEmbed.app`
+shortcuts into `~/Applications/` so the app shows up in Spotlight,
+Dock, and Cmd-Space. Each shortcut is a one-line wrapper that
+`exec`s into the gem-bundled launcher; re-run `echoes install` after
+each `gem update echoes` to refresh the path. `echoes uninstall`
+removes them.
+
+To run from a clone instead:
+
+```sh
+git clone https://github.com/amatsuda/echoes
+cd echoes
+bin/setup
+open Echoes.app          # GUI (PTY-spawned shell per pane)
+open EchoesEmbed.app     # GUI with rubish embedded per pane
+bundle exec exe/echoes -t  # TTY mode
+```
+
+## What's in the box
+
+- **Echoes.app** — terminal mode. Spawns the user's `$SHELL` per
+  pane via PTY, like any other terminal emulator.
+- **EchoesEmbed.app** — same window/UI, but each pane runs `rubish`
+  in-process via a per-pane helper subprocess. Line editing, prompt
+  rendering, and tab completion happen natively in Echoes (no ANSI
+  roundtrip); only command output flows over the pty.
+- **Edit File…** (Cmd+Shift+E) — opens an rvim-backed editor pane.
+  Insert mode, `:w`, `:q`, search, visual mode, undo — the full vim
+  surface. The dialog opens at the active pane's pwd.
+
+## Keyboard shortcuts
+
+| Shortcut                  | Action                                  |
+|---------------------------|-----------------------------------------|
+| Cmd+N                     | New window                              |
+| Cmd+T                     | New tab                                 |
+| Cmd+W                     | Close tab                               |
+| Cmd+Shift+W               | Close pane                              |
+| Cmd+Shift+E               | Edit file… (rvim pane)                  |
+| Cmd+D                     | Split pane right                        |
+| Cmd+Shift+D               | Split pane down                         |
+| Cmd+] / Cmd+[             | Next / previous pane                    |
+| Cmd+Shift+] / Cmd+Shift+[ | Next / previous tab                     |
+| Cmd++ / Cmd+- / Cmd+0     | Bigger / smaller / reset font           |
+| Cmd+F                     | Find                                    |
+| Cmd+G / Cmd+Shift+G       | Find next / previous                    |
+| Cmd+Shift+P               | Toggle mouse pointer visibility         |
+| Cmd+Shift+C               | Toggle copy mode                        |
+| Cmd+Ctrl+F                | Enter / leave full screen               |
+
+## OSC extensions
+
+Echoes recognizes a private OSC namespace under code `7772`. Other
+terminals ignore unknown OSC codes, so emitters degrade gracefully.
+
+```
+\e]7772;bg-color;#rrggbb\a
+\e]7772;bg-gradient;type=linear:angle=N:colors=#rrggbb,#rrggbb\a
+\e]7772;bg-fill;color=#rrggbb:rect=row1,col1,row2,col2\a
+\e]7772;bg-clear\a
+```
+
+`bg-fill` calls accumulate, so a presentation tool can build up a
+slide layout (header bar, sidebar, accent stripe) on top of a base
+`bg-color` or `bg-gradient`. `bg-clear` wipes both the base layer
+and all fills.
+
+OSC 66 is also extended:
+
+- `f=Family Name` selects a font family for the multicell glyph.
+  Proportional fonts are measured per-glyph at layout time so the
+  cells reserved match the actual rendered width — `Hello` in Noto
+  Serif at 2× lays out cleanly without overflow or gaps.
+- `h=` (halign) is honored for non-fractional / proportional text:
+  the whole string lands in a `s × source_chars` cell block, with
+  the renderer's existing center / right-align math applied.
+
+A small Ruby helper (`Echoes::Client`) lets in-pane Ruby tools emit
+these without hand-rolling escape sequences:
+
+```ruby
+require 'echoes/client'
+
+Echoes::Client.bg_gradient(from: '#1a1a2e', to: '#16213e', angle: 90)
+Echoes::Client.bg_fill('#ff6b35', row1: 0, col1: 0, row2: 2, col2: 79)
+Echoes::Client.styled_text("Title", scale: 3, family: "Helvetica Neue")
+Echoes::Client.bg_clear
+```
+
+## Development
+
+```sh
+bin/setup
+bundle exec rake test       # run all tests
+bundle exec exe/echoes      # launch from the working tree
+bin/console                 # irb with the gem loaded
+```
+
+`rake app` syncs `CFBundleVersion` in both bundles' `Info.plist`
+files with `Echoes::VERSION` (run after a version bump).
+
+## Contributing
+
+Bug reports and pull requests welcome at
+<https://github.com/amatsuda/echoes>.
+
+## License
+
+MIT.

data/Rakefile

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test
+
+desc "Sync .app Info.plist CFBundleVersion with Echoes::VERSION"
+task :app do
+  # The .app bundles (Echoes.app, EchoesEmbed.app) are committed
+  # to the repo, including their MacOS/ launcher scripts which
+  # locate `lib/` and `exe/echoes` from the script's own path —
+  # no per-machine rewrite needed. The one thing that drifts on a
+  # version bump is each bundle's Info.plist CFBundleVersion. This
+  # task patches that line in place; everything else (launchers,
+  # bundle id, package type) is left alone so any hand-edits the
+  # bundles have picked up survive.
+  require_relative "lib/echoes/version"
+  version = Echoes::VERSION
+
+  plists = %w[Echoes.app/Contents/Info.plist EchoesEmbed.app/Contents/Info.plist]
+  plists.each do |path|
+    unless File.exist?(path)
+      warn "skipping #{path}: not found"
+      next
+    end
+    text = File.read(path)
+    new_text = text.sub(
+      %r{(<key>CFBundleVersion</key>\s*<string>)[^<]*(</string>)},
+      "\\1#{version}\\2"
+    )
+    if text == new_text
+      puts "#{path}: already at #{version}"
+    else
+      File.write(path, new_text)
+      puts "#{path}: CFBundleVersion → #{version}"
+    end
+  end
+end

data/exe/echoes

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+case ARGV.first
+when 'install', 'uninstall'
+  require 'echoes/installer'
+  Echoes::Installer.public_send(ARGV.shift)
+else
+  require 'echoes'
+  if ARGV.delete('--tty') || ARGV.delete('-t')
+    Echoes::Terminal.new.run
+  else
+    Echoes::GUI.new.run
+  end
+end

data/lib/echoes/cell.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Echoes
+  class Cell
+    attr_accessor :char, :fg, :bg, :bold, :italic, :underline, :underline_color, :inverse, :faint, :strikethrough, :blink, :concealed, :width, :multicell, :hyperlink
+
+    def initialize(char = " ", fg: nil, bg: nil, bold: false, underline: false, inverse: false, width: 1)
+      @char = char
+      @fg = fg
+      @bg = bg
+      @bold = bold
+      @italic = false
+      @underline = underline
+      @inverse = inverse
+      @faint = false
+      @strikethrough = false
+      @width = width
+    end
+
+    def reset!
+      @char = " "
+      @fg = nil
+      @bg = nil
+      @bold = false
+      @italic = false
+      @underline = false
+      @inverse = false
+      @faint = false
+      @strikethrough = false
+      @blink = false
+      @concealed = false
+      @width = 1
+      @multicell = nil
+      @hyperlink = nil
+      @underline_color = nil
+    end
+
+    def copy_from(other)
+      @char = other.char
+      @fg = other.fg
+      @bg = other.bg
+      @bold = other.bold
+      @italic = other.italic
+      @underline = other.underline
+      @underline_color = other.underline_color
+      @inverse = other.inverse
+      @faint = other.faint
+      @strikethrough = other.strikethrough
+      @blink = other.blink
+      @concealed = other.concealed
+      @hyperlink = other.hyperlink
+    end
+  end
+end

data/lib/echoes/client.rb

@@ -0,0 +1,96 @@
+# frozen_string_literal: true
+
+module Echoes
+  # Helpers that emit Echoes-private OSC sequences for tools running
+  # inside an Echoes pane (e.g. a Ruby presentation tool that wants
+  # Keynote-style gradient slide backgrounds). Other terminals ignore
+  # the OSC code, so emitters degrade gracefully.
+  #
+  # Example:
+  #   Echoes::Client.bg_gradient(from: '#1a1a2e', to: '#16213e', angle: 90)
+  #   # ...later, restore the solid background:
+  #   Echoes::Client.bg_clear
+  module Client
+    OSC = "\e]7772"
+    BEL = "\a"
+
+    module_function
+
+    # Paint a linear gradient as the pane's background. `angle` is in
+    # degrees (0 = left→right, 90 = bottom→top, matches NSGradient).
+    # Pass an array of hex strings via `colors:` for endpoints beyond
+    # two (the renderer currently uses first/last only).
+    def bg_gradient(from: nil, to: nil, colors: nil, angle: 0, type: :linear, io: $stdout)
+      colors ||= [from, to]
+      colors = colors.compact.map(&:to_s)
+      raise ArgumentError, 'need at least 2 colors' if colors.size < 2
+
+      args = "type=#{type}:angle=#{angle}:colors=#{colors.join(',')}"
+      io.write("#{OSC};bg-gradient;#{args}#{BEL}")
+      io.flush if io.respond_to?(:flush)
+      nil
+    end
+
+    # Paint the pane's background with a single solid color. The
+    # color paints beneath cell content, so cells with their own
+    # bg color (selection, themed cells, etc.) still occlude
+    # correctly. Pair with bg_clear to revert.
+    #
+    # Example:
+    #   Echoes::Client.bg_color('#1a1a2e')
+    def bg_color(color, io: $stdout)
+      io.write("#{OSC};bg-color;#{color}#{BEL}")
+      io.flush if io.respond_to?(:flush)
+      nil
+    end
+
+    # Paint a rectangular region of the pane on top of the base
+    # background. Calls accumulate — emit several to build up a
+    # layout (header/footer bars, sidebars, accent stripes, etc.).
+    # `bg_clear` wipes the whole list along with the base background.
+    #
+    # Coordinates are 0-indexed cell positions, inclusive on both
+    # ends — i.e. row1=0, col1=0, row2=2, col2=9 paints a 3x10 block.
+    #
+    # Example:
+    #   Echoes::Client.bg_fill('#222',  row1: 0,  col1: 0, row2: 0,  col2: 79)  # status bar
+    #   Echoes::Client.bg_fill('#3a3', row1: 24, col1: 0, row2: 24, col2: 79)  # footer
+    def bg_fill(color, row1:, col1:, row2:, col2:, io: $stdout)
+      args = "color=#{color}:rect=#{row1},#{col1},#{row2},#{col2}"
+      io.write("#{OSC};bg-fill;#{args}#{BEL}")
+      io.flush if io.respond_to?(:flush)
+      nil
+    end
+
+    # Drop any pane background override (bg-color/bg-gradient) AND
+    # all bg-fill overlays. Safe to call when nothing is set.
+    def bg_clear(io: $stdout)
+      io.write("#{OSC};bg-clear#{BEL}")
+      io.flush if io.respond_to?(:flush)
+      nil
+    end
+
+    # Emit text via OSC 66 (multicell), with optional cell-scale,
+    # sub-cell fraction, vertical/horizontal alignment, and font
+    # family. `family:` is an Echoes-specific extension other
+    # terminals ignore. On unknown families, Echoes falls back to the
+    # monospaced system font.
+    #
+    # Examples:
+    #   Echoes::Client.styled_text("Title",   scale: 3, family: "Helvetica Neue")
+    #   Echoes::Client.styled_text("• item",  scale: 1, family: "Menlo")
+    def styled_text(text, scale: 1, width: nil, frac_n: nil, frac_d: nil,
+                    valign: nil, halign: nil, family: nil, io: $stdout)
+      meta = +"s=#{scale}"
+      meta << ":w=#{width}"   if width
+      meta << ":n=#{frac_n}"  if frac_n
+      meta << ":d=#{frac_d}"  if frac_d
+      meta << ":v=#{valign}"  if valign
+      meta << ":h=#{halign}"  if halign
+      meta << ":f=#{family}"  if family
+      io.write("\e]66;#{meta};#{text}\a")
+      io.flush if io.respond_to?(:flush)
+      nil
+    end
+  end
+end

data/lib/echoes/configuration.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module Echoes
+  class Configuration
+    def initialize
+      @font_size = 14.0
+      @rows = 24
+      @cols = 80
+      @shell = ENV['SHELL'] || '/bin/bash'
+      @scrollback_limit = 1000
+      @foreground = [0.9, 0.9, 0.9]
+      @background = [0.0, 0.0, 0.0]
+      @cursor_color = [0.7, 0.7, 0.7, 0.5]
+      @font_family = nil
+      @window_title = 'Echoes'
+      @tab_position = :top
+      @color_palette = nil
+      @term = 'xterm-256color'
+      @word_separators = ' @*.:/\\()"\'-:,.;<>~!#$%^&*|+=[]{}~?│'
+      @selection_color = [0.2, 0.4, 0.7]
+      @pane_divider_color = [0.4, 0.4, 0.4]
+      @active_pane_border_color = [0.3, 0.5, 0.8]
+      @copy_mode_cursor_color = [0.8, 0.7, 0.2]
+    end
+
+    def font_family(val = nil)
+      val ? @font_family = val : @font_family
+    end
+
+    def font_size(val = nil)
+      val ? @font_size = val.to_f : @font_size
+    end
+
+    def rows(val = nil)
+      val ? @rows = val.to_i : @rows
+    end
+
+    def cols(val = nil)
+      val ? @cols = val.to_i : @cols
+    end
+
+    def shell(val = nil)
+      val ? @shell = val : @shell
+    end
+
+    def scrollback_limit(val = nil)
+      val ? @scrollback_limit = val.to_i : @scrollback_limit
+    end
+
+    def foreground(*args)
+      args.empty? ? @foreground : @foreground = parse_color(args)
+    end
+
+    def background(*args)
+      args.empty? ? @background : @background = parse_color(args)
+    end
+
+    def cursor_color(*args)
+      args.empty? ? @cursor_color : @cursor_color = parse_color(args)
+    end
+
+    def window_title(val = nil)
+      val ? @window_title = val : @window_title
+    end
+
+    def tab_position(val = nil)
+      val ? @tab_position = val.to_sym : @tab_position
+    end
+
+    def term(val = nil)
+      val ? @term = val : @term
+    end
+
+    def word_separators(val = nil)
+      val ? @word_separators = val : @word_separators
+    end
+
+    def selection_color(*args)
+      args.empty? ? @selection_color : @selection_color = parse_color(args)
+    end
+
+    def pane_divider_color(*args)
+      args.empty? ? @pane_divider_color : @pane_divider_color = parse_color(args)
+    end
+
+    def active_pane_border_color(*args)
+      args.empty? ? @active_pane_border_color : @active_pane_border_color = parse_color(args)
+    end
+
+    def copy_mode_cursor_color(*args)
+      args.empty? ? @copy_mode_cursor_color : @copy_mode_cursor_color = parse_color(args)
+    end
+
+    def color_palette(val = nil)
+      if val
+        @color_palette = val.map { |c| c.is_a?(String) ? parse_color([c]) : c.map(&:to_f) }
+      else
+        @color_palette
+      end
+    end
+
+    private
+
+    def parse_color(args)
+      if args.size == 1 && args[0].is_a?(String)
+        hex = args[0].delete_prefix('#')
+        r = hex[0, 2].to_i(16) / 255.0
+        g = hex[2, 2].to_i(16) / 255.0
+        b = hex[4, 2].to_i(16) / 255.0
+        if hex.size == 8
+          a = hex[6, 2].to_i(16) / 255.0
+          [r, g, b, a]
+        else
+          [r, g, b]
+        end
+      else
+        args.map(&:to_f)
+      end
+    end
+  end
+
+  CONFIG_PATH = File.join(Dir.home, '.config', 'echoes', 'echoes.conf')
+
+  def self.config
+    @config ||= Configuration.new
+  end
+
+  def self.load_config
+    if File.exist?(CONFIG_PATH)
+      config.instance_eval(File.read(CONFIG_PATH), CONFIG_PATH)
+    end
+  rescue SyntaxError, StandardError => e
+    warn "echoes: error loading #{CONFIG_PATH}: #{e.message}"
+  end
+end