UI

[brillout]

Note

This includes brainstorming ideas (long-term vision). A lot is out-of-scope for the MVP: we can only implement the MVP-relevant parts.

• Sidebars:
  1. First sidebar (on the left):
     • Three sections: Overview, Projects, Queue
       • Projects: shows the list of all projects where The Framework is installed
       • Queue: essentially all the TODO.md entries of all projects
       • Overview: some kind of nice overview of current prompts AI is working on, the queue, and recent projects
  2. Second sidebar (on the left): shows the latest AI loops/prompts of the currently selected project (the most recently active project if none is selected)
     • In other words: clicking a project => essentially shows .the-framework/LOGS.md in the second sidebar
  3. Third sidebar (on the right)
     • Show arbitrary views (e.g. when AI calls the function showMarkdown(), <Choices>, ...)
     • Sticky top nav to jump between views (e.g. for jumping between PLAN.md and TODO.md)
• Main view: shows the last loop/prompt of the selected project (similar to https://claude.ai/code).
• Installing projects
  • A repo is activated when it has a .the-framework/ directory
  • Installation: the user can click on a button "Add project(s)" => user can add a directory of repos, or a single repo
    • When adding a directory: add all child directories that are Git repos
    • Commits an empty .the-framework/LOGS.md with commit message [The Framework] install The Framework
      • If the Git repo is dirty, then commit the uncommitted changes with a commit message [The Framework] uncommitted changes
• <Choices>
  • When AI needs the user to choose between a list of options to proceed
  • Ideally, choices always have a recommended choice (if a recommendation is missing, then pick first choice)
  • Click green button Accept (or shortcut Ctrl + Enter) => accepts (picks the recommended choices)
  • If [x] autopilot => auto-accepts after 10 seconds (while the UI says "move mouse to abort countdown")
  • All sets of choices (Choices[], not Choice[]) are shown at once in the right sidebar (no pagination, long vertical scroll instead, with sticky top nav to quick-jump between all the sets of choices)
• Global options
  • boolean Autopilot (whether to auto-accept)
  • boolean Technical control (expose technical details, e.g. for tech stack)
  • boolean Eco (fine-grain control over system prompt to save resources)
    • boolean Auto planning
    • boolean Auto research
    • boolean Auto maintenance
  • boolean Vanilla (remove all system prompts, fully transparent, same as directly using Claude Code)
• Context selector — multi-select dropdown (to select list of directories)
  • This just adds one line to the system prompt: Context: [list-of-dirs]
  • AI always has access to all repos (but it doesn't mean it should read all repos, we therefore need a "context selector")
    • When adding repos: "Do you trust this repository? ("You must trust it, otherwise high risk of [prompt injection](link-that-explains-the-problem).")

[suleimansh]

Built the MVP-relevant slice: the Global options checklist item.

• Global options: run-engine + start-flow plumbing #370 (PR feat(framework): thread Global options through the run engine (#370) #372): run-engine + start-flow plumbing. --vanilla removes the built-in prompt; --eco-* drop the matching System prompt #326 sections; Autopilot/Technical map to modes. Options ride the POST /api/start body.
• Global options: dashboard panel (UI) #371 (PR feat(framework): Global options panel on the dashboard (#371) #373): the dashboard panel (Autopilot / Technical / Vanilla / Eco + sub-toggles), localStorage-persisted, sent with each Start. Flipping a toggle changes the MVP transparency — show real prompt (that includes the system prompt) #343 Prompts panel live.

Deferred (needs multi-project state + the .md DB in #313, still unbuilt):

• First sidebar (Overview / Projects / Queue) and the per-project second sidebar (.the-framework/LOGS.md).
• Main view showing the selected project's last loop.
• Installing projects: "Add project(s)", activating a repo via .the-framework/, the install/uncommitted git commits.
• The Context selector's repo-trust / prompt-injection flow. (The trivial "add one Context: line to the system prompt" part can land later on its own; the trust UI is what is deferred.)

The <Choices> third sidebar and its autopilot countdown already exist from earlier work (#304/#311/#332/#358).