rails_console_ai 0.28.0 → 0.30.0

data/app/models/rails_console_ai/skill.rb

@@ -0,0 +1,198 @@
+require 'json'
+
+module RailsConsoleAi
+  class Skill < ActiveRecord::Base
+    self.table_name = 'rails_console_ai_skills'
+
+    STATUS_PROPOSED = 'proposed'.freeze
+    STATUS_APPROVED = 'approved'.freeze
+    STATUSES = [STATUS_PROPOSED, STATUS_APPROVED].freeze
+
+    # Attributes that, if changed, invalidate the current approval and revert
+    # the skill back to "proposed". Status / approver columns are excluded so
+    # that an explicit approve! call doesn't reset its own approval.
+    CONTENT_ATTRIBUTES = %w[name description body tags bypass_guards_for_methods].freeze
+
+    has_many :versions,
+             -> { order(created_at: :desc) },
+             class_name: 'RailsConsoleAi::SkillVersion',
+             foreign_key: :skill_id,
+             dependent: :nullify
+
+    validates :name, presence: true, uniqueness: { case_sensitive: false }
+    validates :status, inclusion: { in: STATUSES }, if: :has_attribute_status?
+
+    scope :alphabetical, -> { order(Arel.sql('LOWER(name)')) }
+    scope :approved, -> { where(status: STATUS_APPROVED) }
+    scope :proposed, -> { where(status: STATUS_PROPOSED) }
+
+    def self.connection
+      klass = RailsConsoleAi.configuration.connection_class
+      if klass
+        klass = Object.const_get(klass) if klass.is_a?(String)
+        klass.connection
+      else
+        super
+      end
+    end
+
+    # Manual JSON accessors keep us off Rails-version-specific `serialize` syntax
+    # (positional coder in Rails 5–6, keyword coder in Rails 7+).
+    def tags
+      decode_json_array(read_attribute(:tags))
+    end
+
+    def tags=(value)
+      write_attribute(:tags, encode_json_array(value))
+    end
+
+    def bypass_guards_for_methods
+      decode_json_array(read_attribute(:bypass_guards_for_methods))
+    end
+
+    def bypass_guards_for_methods=(value)
+      write_attribute(:bypass_guards_for_methods, encode_json_array(value))
+    end
+
+    # Defensive accessors — if `ai_db_migrate` hasn't been run yet, the status
+    # / approval columns may be missing on an older table. Return safe defaults
+    # instead of blowing up with NameError.
+    def status
+      has_attribute_status? ? read_attribute(:status) : STATUS_PROPOSED
+    end
+
+    def approved_by
+      has_attribute?(:approved_by) ? read_attribute(:approved_by) : nil
+    end
+
+    def approved_at
+      has_attribute?(:approved_at) ? read_attribute(:approved_at) : nil
+    end
+
+    def proposed?; status.to_s == STATUS_PROPOSED; end
+    def approved?; status.to_s == STATUS_APPROVED; end
+
+    def to_hash
+      {
+        'id'                        => id,
+        'name'                      => name,
+        'description'               => description,
+        'body'                      => body,
+        'tags'                      => tags,
+        'bypass_guards_for_methods' => bypass_guards_for_methods,
+        'status'                    => status,
+        'approved_by'               => approved_by,
+        'approved_at'               => approved_at,
+        'use_count'                 => use_count,
+        'last_used_at'              => last_used_at,
+        'source'                    => :db,
+        'updated_at'                => updated_at
+      }
+    end
+
+    def has_attribute_status?
+      has_attribute?(:status)
+    end
+
+    # Atomically bump use_count + last_used_at without firing callbacks /
+    # validations / updated_at. Safe to call from concurrent AI tool calls.
+    # No-op (returns false) if the table doesn't have the columns yet — that
+    # keeps older installs working until they run ai_db_migrate.
+    def self.record_use!(id)
+      return false unless connection.column_exists?(table_name, :use_count)
+      where(id: id).update_all([
+        'use_count = COALESCE(use_count, 0) + 1, last_used_at = ?',
+        Time.now.utc
+      ])
+      true
+    rescue ::ActiveRecord::ActiveRecordError => e
+      RailsConsoleAi.logger.warn("RailsConsoleAi::Skill.record_use!(#{id.inspect}) failed: #{e.message}")
+      false
+    end
+
+    def use_count
+      has_attribute?(:use_count) ? (read_attribute(:use_count) || 0) : 0
+    end
+
+    def last_used_at
+      has_attribute?(:last_used_at) ? read_attribute(:last_used_at) : nil
+    end
+
+    def self.decode_json_array(raw)
+      return [] if raw.nil? || (raw.respond_to?(:empty?) && raw.empty?)
+      return raw if raw.is_a?(Array)
+      JSON.parse(raw)
+    rescue JSON::ParserError
+      []
+    end
+
+    def self.encode_json_array(value)
+      JSON.dump(Array(value))
+    end
+
+    def decode_json_array(raw)
+      self.class.decode_json_array(raw)
+    end
+
+    def encode_json_array(value)
+      self.class.encode_json_array(value)
+    end
+
+    # Assigns attrs, saves, and records one SkillVersion snapshot of the post-save state.
+    # Every save produces exactly one version row, so the version log is a complete history
+    # including the current state (the most recent version mirrors `self`).
+    #
+    # If `preserve_approval` is false (the default), any change to a content attribute
+    # reverts the skill back to "proposed" and clears the approver. Pass true from the
+    # approve! flow so approval doesn't reset itself.
+    def update_with_version!(attrs, edited_by: nil, change_note: nil, preserve_approval: false)
+      transaction do
+        assign_attributes(attrs)
+
+        if !preserve_approval && approved? && content_dirty?
+          self.status      = STATUS_PROPOSED
+          self.approved_by = nil
+          self.approved_at = nil
+        end
+
+        save!
+        RailsConsoleAi::SkillVersion.create!(
+          skill_id:                   id,
+          name:                       name,
+          description:                description,
+          body:                       body,
+          tags:                       tags,
+          bypass_guards_for_methods:  bypass_guards_for_methods,
+          status:                     status,
+          edited_by:                  edited_by,
+          change_note:                change_note
+        )
+      end
+      self
+    end
+
+    # Marks the current head as approved. Logs a version row with the approver name
+    # so the audit trail captures the approval moment.
+    def approve!(approved_by:)
+      raise ArgumentError, 'approved_by is required' if approved_by.to_s.strip.empty?
+
+      update_with_version!(
+        {
+          status:      STATUS_APPROVED,
+          approved_by: approved_by,
+          approved_at: Time.now.utc
+        },
+        edited_by: approved_by,
+        change_note: "Approved by #{approved_by}",
+        preserve_approval: true
+      )
+    end
+
+    private
+
+    # Did any content-bearing attribute change in this assign_attributes pass?
+    def content_dirty?
+      CONTENT_ATTRIBUTES.any? { |a| changes.key?(a) }
+    end
+  end
+end

data/app/models/rails_console_ai/skill_version.rb

@@ -0,0 +1,54 @@
+require 'json'
+
+module RailsConsoleAi
+  class SkillVersion < ActiveRecord::Base
+    self.table_name = 'rails_console_ai_skill_versions'
+
+    belongs_to :skill,
+               class_name: 'RailsConsoleAi::Skill',
+               foreign_key: :skill_id,
+               optional: true
+
+    scope :recent, -> { order(created_at: :desc) }
+
+    def self.connection
+      klass = RailsConsoleAi.configuration.connection_class
+      if klass
+        klass = Object.const_get(klass) if klass.is_a?(String)
+        klass.connection
+      else
+        super
+      end
+    end
+
+    def tags
+      decode_json_array(read_attribute(:tags))
+    end
+
+    def tags=(value)
+      write_attribute(:tags, encode_json_array(value))
+    end
+
+    def bypass_guards_for_methods
+      decode_json_array(read_attribute(:bypass_guards_for_methods))
+    end
+
+    def bypass_guards_for_methods=(value)
+      write_attribute(:bypass_guards_for_methods, encode_json_array(value))
+    end
+
+    private
+
+    def decode_json_array(raw)
+      return [] if raw.nil? || (raw.respond_to?(:empty?) && raw.empty?)
+      return raw if raw.is_a?(Array)
+      JSON.parse(raw)
+    rescue JSON::ParserError
+      []
+    end
+
+    def encode_json_array(value)
+      JSON.dump(Array(value))
+    end
+  end
+end

data/app/views/layouts/rails_console_ai/application.html.erb

@@ -70,14 +70,91 @@
     .pagination a:hover { background: #f8f9fa; text-decoration: none; }
     .pagination .disabled { padding: 6px 14px; font-size: 13px; color: #ccc; }
     .pagination .page-info { font-size: 13px; color: #888; }
+    .nav-links a { margin-left: 16px; }
+    .btn {
+      display: inline-block; padding: 7px 14px; border-radius: 4px;
+      background: #4a6fa5; color: #fff !important; border: 0;
+      font-size: 13px; cursor: pointer; text-decoration: none;
+    }
+    .btn:hover { background: #3a5a85; text-decoration: none; }
+    .btn-secondary { background: #6c757d; }
+    .btn-secondary:hover { background: #5a6268; }
+    .btn-danger { background: #dc3545; }
+    .btn-danger:hover { background: #c82333; }
+    .btn-bar { display: flex; gap: 8px; margin: 16px 0; flex-wrap: wrap; }
+    .source-db { background: #cce5ff; color: #004085; }
+    .source-file { background: #e2e3e5; color: #383d41; }
+    .source-builtin { background: #e0d4ff; color: #4a2d8c; }
+    .status-approved { background: #d4edda; color: #155724; }
+    .status-proposed { background: #fff3cd; color: #856404; }
+    .form-row { margin-bottom: 14px; }
+    .form-row label {
+      display: block; font-size: 12px; font-weight: 600;
+      color: #555; text-transform: uppercase; margin-bottom: 4px;
+    }
+    .form-row input[type="text"], .form-row textarea {
+      width: 100%; padding: 8px 10px; font-size: 14px;
+      border: 1px solid #ccc; border-radius: 4px;
+      font-family: -apple-system, BlinkMacSystemFont, sans-serif;
+    }
+    .form-row textarea {
+      font-family: "SF Mono", "Monaco", "Menlo", "Consolas", monospace;
+      font-size: 13px;
+    }
+    .form-row .hint { font-size: 12px; color: #888; margin-top: 4px; }
+    .form-card {
+      background: #fff; border-radius: 8px; padding: 24px;
+      box-shadow: 0 1px 3px rgba(0,0,0,0.1); margin-bottom: 24px;
+    }
+    .flash { padding: 12px 16px; border-radius: 4px; margin-bottom: 16px; font-size: 14px; }
+    .flash-notice { background: #d4edda; color: #155724; }
+    .flash-alert { background: #f8d7da; color: #721c24; }
+    .markdown-body {
+      background: #fff; border-radius: 8px; padding: 20px;
+      box-shadow: 0 1px 3px rgba(0,0,0,0.1); margin-bottom: 16px;
+      white-space: pre-wrap; font-family: "SF Mono", monospace; font-size: 13px;
+    }
+    .versions-list { background: #fff; border-radius: 8px; padding: 0; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+    .versions-list .ver-row {
+      display: flex; align-items: center; justify-content: space-between;
+      padding: 10px 16px; border-bottom: 1px solid #f0f0f0; font-size: 13px;
+    }
+    .versions-list .ver-row:last-child { border-bottom: 0; }
+    .versions-list .ver-meta { color: #888; font-size: 12px; }
+    .diff-table {
+      width: 100%; border-collapse: collapse; background: #fff;
+      border-radius: 8px; overflow: hidden; box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+    }
+    .diff-table th { background: #f8f9fa; padding: 8px 12px; text-align: left; font-size: 12px; }
+    .diff-table td {
+      vertical-align: top; padding: 0; width: 50%; border-bottom: 1px solid #f0f0f0;
+    }
+    .diff-table pre {
+      margin: 0; padding: 4px 12px; font-family: "SF Mono", monospace;
+      font-size: 12px; white-space: pre-wrap; word-break: break-word;
+    }
+    .diff-add { background: #d4edda; }
+    .diff-del { background: #f8d7da; }
+    .tag {
+      display: inline-block; padding: 2px 8px; margin-right: 4px;
+      background: #e9ecef; color: #495057; border-radius: 10px; font-size: 11px;
+    }
+    .inline-form { display: inline; }
   </style>
 </head>
 <body>
   <div class="header">
     <h1>RailsConsoleAi Admin</h1>
-    <a href="<%= rails_console_ai.root_path %>">Sessions</a>
+    <div class="nav-links">
+      <a href="<%= rails_console_ai.root_path %>">Sessions</a>
+      <a href="<%= rails_console_ai.skills_path %>">Skills</a>
+      <a href="<%= rails_console_ai.memories_path %>">Memories</a>
+      <a href="<%= rails_console_ai.agents_path %>">Agents</a>
+    </div>
   </div>
   <div class="container">
+    <% if flash[:notice] %><div class="flash flash-notice"><%= flash[:notice] %></div><% end %>
+    <% if flash[:alert]  %><div class="flash flash-alert"><%= flash[:alert] %></div><% end %>
     <%= yield %>
   </div>
 </body>

data/app/views/rails_console_ai/agent_versions/index.html.erb

@@ -0,0 +1,28 @@
+<%= link_to '← Back to agent', agent_path(@agent), class: 'back-link' %>
+
+<h2 style="margin-bottom:16px;">Versions — <%= @agent.name %></h2>
+
+<% if @versions.empty? %>
+  <div class="meta-card"><p class="text-muted">No versions recorded yet.</p></div>
+<% else %>
+  <div class="versions-list">
+    <% @versions.each do |v| %>
+      <div class="ver-row">
+        <div>
+          <strong>v<%= v.id %></strong>
+          <span class="ver-meta">— <%= v.created_at.strftime('%Y-%m-%d %H:%M:%S') %> by <%= v.edited_by || 'unknown' %></span>
+          <% if v.status == 'approved' %><span class="badge status-approved">APPROVED</span>
+          <% elsif v.status == 'proposed' %><span class="badge status-proposed">PROPOSED</span><% end %>
+          <% if v.change_note.present? %><div class="ver-meta"><%= v.change_note %></div><% end %>
+        </div>
+        <div>
+          <%= link_to 'View', agent_version_path(@agent, v) %>
+          ·
+          <%= link_to 'Diff vs current', diff_agents_path(agent_id: @agent.id, from: v.id) %>
+          ·
+          <%= button_to 'Restore', restore_agent_version_path(@agent, v), method: :post, class: 'btn btn-secondary', form: { style: 'display:inline' }, data: { confirm: "Restore version ##{v.id}? Restoring reverts the agent to PROPOSED and a new version row will be created." } %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+<% end %>

data/app/views/rails_console_ai/agent_versions/show.html.erb

@@ -0,0 +1,25 @@
+<%= link_to '← All versions', agent_versions_path(@agent), class: 'back-link' %>
+
+<div class="meta-card">
+  <h2 style="margin-bottom:8px;"><%= @version.name %> <span class="badge source-db">v<%= @version.id %></span></h2>
+  <p class="text-muted"><%= @version.description %></p>
+  <div class="meta-grid" style="margin-top:16px;">
+    <div class="meta-item"><label>Edited by</label><span><%= @version.edited_by || '—' %></span></div>
+    <div class="meta-item"><label>At</label><span><%= @version.created_at.strftime('%Y-%m-%d %H:%M:%S') %></span></div>
+    <div class="meta-item"><label>Status</label><span><%= @version.status || '—' %></span></div>
+    <div class="meta-item"><label>Model</label><span><%= @version.model || '(default)' %></span></div>
+    <div class="meta-item"><label>Max rounds</label><span><%= @version.max_rounds || '(default)' %></span></div>
+    <div class="meta-item"><label>Tools</label><span><%= Array(@version.tools).join(', ').presence || '(default set)' %></span></div>
+  </div>
+  <% if @version.change_note.present? %>
+    <p style="margin-top:12px;"><strong>Change note:</strong> <%= @version.change_note %></p>
+  <% end %>
+</div>
+
+<div class="btn-bar">
+  <%= button_to "Restore this version", restore_agent_version_path(@agent, @version), method: :post, class: 'btn btn-danger', data: { confirm: "Restore version ##{@version.id}? Current agent will be overwritten and status reverted to PROPOSED." } %>
+  <%= link_to 'Diff vs current', diff_agents_path(agent_id: @agent.id, from: @version.id), class: 'btn btn-secondary' %>
+</div>
+
+<h3 style="margin-top:24px; margin-bottom:8px;">Body / instructions</h3>
+<div class="markdown-body"><%= @version.body %></div>

data/app/views/rails_console_ai/agents/_form.html.erb

@@ -0,0 +1,65 @@
+<% if @agent.persisted? && @agent.respond_to?(:approved?) && @agent.approved? %>
+  <div class="flash flash-alert" style="margin-bottom:16px;">
+    Heads up: this agent is currently <strong>approved</strong>. Editing it will revert its status to <strong>proposed</strong> and the AI won't be able to invoke it again until someone re-approves it.
+  </div>
+<% elsif !@agent.persisted? %>
+  <div class="flash flash-notice" style="margin-bottom:16px;">
+    New DB agents start as <strong>proposed</strong>. After saving, an approver (likely you) needs to click the Approve button on the show page before the AI can invoke this agent via delegate_task.
+  </div>
+<% end %>
+
+<%= form_with model: @agent, url: form_url, method: form_method, local: true do |f| %>
+  <div class="form-card">
+    <div class="form-row">
+      <label>Name</label>
+      <%= f.text_field :name, value: @agent.name, required: true %>
+    </div>
+
+    <div class="form-row">
+      <label>Description</label>
+      <%= f.text_field :description, value: @agent.description, placeholder: 'One-line description of what this agent specializes in' %>
+    </div>
+
+    <div class="form-row">
+      <label>Body / system instructions (markdown)</label>
+      <%= f.text_area :body, value: @agent.body, rows: 18 %>
+      <div class="hint">Persona + strategy + rules. Be specific about what tools/approaches the sub-agent should use and what format its summary should take.</div>
+    </div>
+
+    <div class="form-row">
+      <label>Max rounds (optional)</label>
+      <%= f.number_field :max_rounds, value: @agent.max_rounds, min: 1, max: 100 %>
+      <div class="hint">Maximum tool-loop iterations for the sub-agent. Defaults to the global <code>config.sub_agent_max_rounds</code>. Smaller = tighter scope, fewer tokens.</div>
+    </div>
+
+    <div class="form-row">
+      <label>Model (optional)</label>
+      <%= f.text_field :model, value: @agent.model, placeholder: 'e.g. claude-haiku-4-5' %>
+      <div class="hint">Model override. Leave blank to use the global model. Useful for cheap/fast agents.</div>
+    </div>
+
+    <div class="form-row">
+      <label>Tool whitelist (one per line, optional)</label>
+      <%= f.text_area :tools, value: Array(@agent.tools).join("\n"), rows: 4 %>
+      <div class="hint">Tool names the sub-agent is allowed to call (e.g. <code>execute_code</code>, <code>search_code</code>, <code>read_file</code>). Leave blank to use the default tool set. Adding tools here can broaden what the sub-agent can do — this is why DB agents need approval.</div>
+    </div>
+
+    <hr style="margin: 20px 0; border: 0; border-top: 1px solid #eee;">
+
+    <div class="form-row">
+      <label>Edited by</label>
+      <input type="text" name="edited_by" value="<%= params[:edited_by] %>" placeholder="Your name or handle">
+      <div class="hint">Recorded with this version. Free text — the gem does not assume authentication beyond the admin login.</div>
+    </div>
+
+    <div class="form-row">
+      <label>Change note (optional)</label>
+      <input type="text" name="change_note" value="" placeholder="What did you change and why?">
+    </div>
+  </div>
+
+  <div class="btn-bar">
+    <%= f.submit submit_label, class: 'btn' %>
+    <%= link_to 'Cancel', cancel_path, class: 'btn btn-secondary' %>
+  </div>
+<% end %>

data/app/views/rails_console_ai/agents/diff.html.erb

@@ -0,0 +1,19 @@
+<%= link_to '← Back to agent', agent_path(@agent), class: 'back-link' %>
+
+<h2 style="margin-bottom:8px;">Diff — <%= @agent.name %></h2>
+<p class="text-muted" style="margin-bottom:16px;">
+  Version #<%= @from.id %> (<%= @from.created_at.strftime('%Y-%m-%d %H:%M') %>) → <%= @to_label %>
+</p>
+
+<h3 style="margin:16px 0 6px;">Body</h3>
+<%= render_text_diff(@from.body, @to_body, left_label: "v##{@from.id}", right_label: @to_label) %>
+
+<h3 style="margin:24px 0 6px;">Tool whitelist</h3>
+<%= render_json_diff(Array(@from.tools), @to_tools, left_label: "v##{@from.id}", right_label: @to_label) %>
+
+<div class="btn-bar" style="margin-top:24px;">
+  <% if @to.nil? %>
+    <%= button_to "Restore v##{@from.id}", restore_agent_version_path(@agent, @from), method: :post, class: 'btn btn-danger', data: { confirm: 'Restoring will overwrite the current agent (a new version row is created) and revert status to PROPOSED.' } %>
+  <% end %>
+  <%= link_to 'Back', agent_path(@agent), class: 'btn btn-secondary' %>
+</div>

data/app/views/rails_console_ai/agents/edit.html.erb

@@ -0,0 +1,7 @@
+<%= link_to '← Back to agent', agent_path(@agent), class: 'back-link' %>
+<h2 style="margin-bottom:16px;">Edit agent</h2>
+<%= render 'form',
+      form_url: agent_path(@agent),
+      form_method: :patch,
+      submit_label: 'Save changes',
+      cancel_path: agent_path(@agent) %>

data/app/views/rails_console_ai/agents/index.html.erb

@@ -0,0 +1,80 @@
+<div class="btn-bar">
+  <%= link_to 'New agent', new_agent_path, class: 'btn' %>
+  <% if @sort == 'used' %>
+    <%= link_to 'Sort: alphabetical', agents_path(q: @q), class: 'btn btn-secondary' %>
+  <% else %>
+    <%= link_to 'Sort: most used', agents_path(q: @q, sort: 'used'), class: 'btn btn-secondary' %>
+  <% end %>
+  <form method="get" action="<%= agents_path %>" style="margin-left:auto;">
+    <input type="text" name="q" value="<%= @q %>" placeholder="Search agents…" style="padding:6px 10px; border:1px solid #ccc; border-radius:4px;">
+    <% if @sort.present? %><input type="hidden" name="sort" value="<%= @sort %>"><% end %>
+  </form>
+</div>
+
+<% proposed_count = @agents.count { |a| a['source'] == :db && a['status'] != 'approved' } %>
+<% if proposed_count > 0 %>
+  <div class="flash flash-alert" style="margin-bottom:16px;">
+    <strong><%= proposed_count %></strong> agent<%= proposed_count == 1 ? '' : 's' %> awaiting approval. The AI cannot invoke them via delegate_task until a human approves.
+  </div>
+<% end %>
+
+<% if @agents.empty? %>
+  <div class="meta-card">
+    <p class="text-muted">No agents found. <%= link_to 'Create one', new_agent_path %> or drop a Markdown file in <code>.rails_console_ai/agents/</code>.</p>
+  </div>
+<% else %>
+  <table>
+    <thead>
+      <tr>
+        <th>Name</th>
+        <th>Description</th>
+        <th>Model</th>
+        <th>Source / Status</th>
+        <th title="Number of times delegate_task invoked this agent (DB only)">Uses</th>
+        <th>Last used</th>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @agents.each do |a| %>
+        <% link_id = a['id'] || a['name'] %>
+        <tr>
+          <td><strong><%= link_to a['name'], agent_path(link_id) %></strong></td>
+          <td class="query-cell"><%= a['description'] %></td>
+          <td class="mono"><%= a['model'] || '—' %></td>
+          <td>
+            <% case a['source'] %>
+            <% when :db %>
+              <span class="badge source-db">DB</span>
+              <% if a['status'] == 'approved' %>
+                <span class="badge status-approved">APPROVED</span>
+              <% else %>
+                <span class="badge status-proposed">PROPOSED</span>
+              <% end %>
+            <% when :file %>
+              <span class="badge source-file">FILE</span>
+            <% when :builtin %>
+              <span class="badge source-builtin">BUILTIN</span>
+            <% end %>
+          </td>
+          <td>
+            <% if a['source'] == :db %>
+              <%= a['use_count'] || 0 %>
+            <% else %>
+              <span class="text-muted">—</span>
+            <% end %>
+          </td>
+          <td class="text-muted" style="font-size:12px;">
+            <%= a['last_used_at']&.strftime('%Y-%m-%d %H:%M') || '—' %>
+          </td>
+          <td>
+            <%= link_to 'View', agent_path(link_id) %>
+            <% if a['source'] == :db %>
+              · <%= link_to 'Edit', edit_agent_path(a['id']) %>
+            <% end %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% end %>

data/app/views/rails_console_ai/agents/new.html.erb

@@ -0,0 +1,24 @@
+<%= link_to '← All agents', agents_path, class: 'back-link' %>
+<h2 style="margin-bottom:16px;">New agent</h2>
+
+<%= form_with url: import_agents_path, method: :post, local: true do %>
+  <div class="form-card" style="background:#f8f9fa;">
+    <div class="form-row" style="margin-bottom:8px;">
+      <label>Paste a .md file (optional)</label>
+      <textarea name="content" rows="14" placeholder="---&#10;name: My agent&#10;description: What it specializes in&#10;max_rounds: 10&#10;model: claude-haiku-4-5&#10;tools: [execute_code, search_code]&#10;---&#10;&#10;Persona, strategy, rules …"></textarea>
+      <div class="hint">
+        Paste the full contents of a Markdown file (YAML frontmatter + body) — same
+        format as <code>.rails_console_ai/agents/*.md</code> or the built-in agents
+        shipped with the gem. Useful for moving an existing on-disk agent into the
+        versioned DB store.
+      </div>
+    </div>
+    <button type="submit" class="btn btn-secondary">Parse pasted content ↓</button>
+  </div>
+<% end %>
+
+<%= render 'form',
+      form_url: agents_path,
+      form_method: :post,
+      submit_label: 'Create agent',
+      cancel_path: agents_path %>