lazyrails-tui 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4f067de1878cccd54415b2a30297a30418a533563d6e04b7279f0c2b5f591a37
+  data.tar.gz: 7388911547568ac6133517d410089eada3180928dc04078b51b900479de21aa2
+SHA512:
+  metadata.gz: 7b429462108c2c9675925abd819af28d7a2ce15f9508f72c132d50d84b9171441de002afaa99e1c5d4594ac907d89406f789799641405eedc335194f744a44c5
+  data.tar.gz: 54eaf790e1b52e4ebc7e712d45fb838a03acce70b2fb349af337a0853302ebf8d4be7aeae22b4e4a6980ead16eaa7fbba79f7e5190126f7adbeb35163a7a5c0b

data/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-03-06
+
+### Added
+
+- Split-pane TUI with 14 panels: Status, Server, Routes, Database, Models, Tests, Gems, Rake, Console, Credentials, Logs, Mailers, Jobs, Custom Commands
+- Rails introspection via `rails runner` for routes, migrations, models, associations, validations, rake tasks
+- Fallback schema.rb parsing when Rails can't boot
+- Dev server management (start/stop/restart) with bin/dev support
+- Live log tailing with slow request and error filtering
+- Test runner with per-file and full-suite execution (RSpec and Minitest)
+- Interactive table data browser with WHERE, ORDER BY, and pagination
+- Generator menu for models, migrations, controllers, scaffolds, jobs, mailers, channels, and stimulus controllers
+- Rails console integration with expression evaluation
+- Credentials viewer with per-environment decryption
+- Mailer preview rendering
+- Solid Queue jobs panel with retry, discard, dispatch, and status filtering
+- Gem management with update and homepage links
+- Command log with full history and undo support
+- Three-tier confirmation system (green/yellow/red) for destructive operations
+- Custom commands via `.lazyrails.yml` configuration
+- Filterable panels with `/` search

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LazyRails Contributors
+
+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,124 @@
+# LazyRails
+
+A [lazygit](https://github.com/jesseduffield/lazygit)-style terminal UI for Rails. Everything the Rails CLI can do, in one split-pane interface.
+
+<!-- TODO: add screenshot or demo GIF here -->
+
+Built with [Chamomile](https://github.com/xjackk/chamomile) (chamomile + petals + flourish).
+
+## Install
+
+```
+gem install lazyrails
+```
+
+Or in your Gemfile:
+
+```ruby
+gem "lazyrails", group: :development
+```
+
+Requires Ruby >= 3.2.
+
+## Usage
+
+```
+cd your-rails-app
+lazyrails
+```
+
+## What's in it
+
+LazyRails has 13 panels you can tab between. Each one wraps a chunk of the Rails CLI:
+
+| Panel       | What you get                                         |
+|-------------|------------------------------------------------------|
+| Status      | Rails/Ruby version, env, app name, git branch, stats |
+| Server      | Start/stop/restart your dev server (supports bin/dev)|
+| Routes      | All routes — filter, group by controller             |
+| Database    | Migrations with status, run up/down, browse table data with WHERE/ORDER BY |
+| Models      | Columns, associations, validations                   |
+| Tests       | Run individual files or the full suite (RSpec + Minitest) |
+| Gems        | Everything in Gemfile.lock — update, open homepage   |
+| Rake        | All rake tasks                                       |
+| Console     | Evaluate Ruby expressions without leaving the TUI    |
+| Credentials | Decrypt and view per-environment credentials         |
+| Logs        | Live request log tailing, filter by slow/errors      |
+| Mailers     | Preview mailers, render output, open in browser      |
+| Jobs        | Solid Queue — retry, discard, dispatch, filter by status |
+
+If you add a `.lazyrails.yml`, you also get a Custom Commands panel (see below).
+
+## Keybindings
+
+`?` opens the full help overlay inside the app. Here are the essentials:
+
+**Navigation:** `Tab`/`Shift+Tab` cycle panels, `1`-`9` jump, `j`/`k` scroll, `Enter` select, `/` filter, `q` quit.
+
+**Global:** `G` generator menu, `x` panel action menu, `R` refresh, `L` command log, `z` undo.
+
+Each panel has its own keys — `s`/`S`/`r` for server, `m`/`M` for migrations, `a`/`f` for tests, etc. Press `x` on any panel to see what's available, or `?` for the full list.
+
+## Generator menu
+
+Press `G` from anywhere to scaffold new code. Pick a type (model, migration, controller, scaffold, job, mailer, channel, stimulus), type the arguments, and it runs `rails generate` for you.
+
+## Table browser
+
+From the Database panel, press `t` to browse table data. You can set WHERE clauses, ORDER BY, and page through results. It's raw SQL against your dev database — useful for poking around without opening a console.
+
+## Jobs (Solid Queue)
+
+If your app uses Solid Queue, the Jobs panel shows all queued/running/failed/scheduled jobs. You can retry or discard failed jobs, dispatch scheduled jobs early, and filter by status. If Solid Queue isn't installed, the panel just says so — no crash.
+
+## Custom commands
+
+Create `.lazyrails.yml` in your Rails root:
+
+```yaml
+custom_commands:
+  - name: "Seed Database"
+    key: "s"
+    command: "bin/rails db:seed"
+    confirmation: yellow
+  - name: "Reset Database"
+    key: "r"
+    command: "bin/rails db:reset"
+    confirmation: red
+```
+
+Confirmation levels: `green` (runs immediately), `yellow` (y/n prompt), `red` (type the panel name to confirm).
+
+## Safety
+
+LazyRails won't let you accidentally nuke your database. Destructive commands go through confirmation tiers:
+
+- `db:migrate`, `bundle update <gem>` — just runs
+- `db:rollback`, `bundle update` — asks y/n
+- `db:drop`, `db:reset` — you have to type the panel name to confirm
+
+Every command is logged. Press `L` to see what ran, and `z` to undo the last reversible action.
+
+## How it works
+
+LazyRails shells out to `rails runner` to introspect your app — routes, migrations, models, associations, validations, rake tasks — and gets structured JSON back. This is more reliable than parsing CLI text output.
+
+If Rails can't boot (missing gems, broken config), it falls back to parsing `db/schema.rb` and model files directly so you still get something useful.
+
+## Development
+
+```
+git clone https://github.com/xjackk/lazyrails
+cd lazyrails
+bundle install
+bundle exec ruby bin/lazyrails /path/to/rails/app
+```
+
+```
+bundle exec rspec
+bundle exec rubocop
+```
+
+## License
+
+MIT

data/bin/lazyrails

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "lazyrails"
+
+case ARGV[0]
+when "--version", "-v"
+  puts "lazyrails #{LazyRails::VERSION}"
+  exit 0
+when "--help", "-h"
+  puts <<~HELP
+    Usage: lazyrails [directory]
+
+    A lazygit-style terminal UI for the Rails command line.
+
+    Options:
+      -v, --version    Show version
+      -h, --help       Show this help
+
+    Run without arguments inside a Rails project, or pass a path:
+      lazyrails /path/to/rails/app
+  HELP
+  exit 0
+when /\A-/
+  warn "Unknown option: #{ARGV[0]}"
+  warn "Run 'lazyrails --help' for usage."
+  exit 1
+end
+
+dir = ARGV[0] || Dir.pwd
+
+project = LazyRails::Project.detect(dir)
+if project.nil?
+  warn "Not a Rails project: #{dir}"
+  warn "Expected to find bin/rails or a Gemfile with 'rails'"
+  exit 1
+end
+
+if project.old_rails?
+  warn "Warning: Detected Rails #{project.rails_version} — some features may not work"
+end
+
+app = LazyRails::App.new(project)
+Chamomile.run(app, alt_screen: true)