docs: update README and agents

Author: Dimillian

AGENTS.md

@@ -7,12 +7,24 @@ CodexMonitor is a macOS Tauri app that orchestrates Codex agents across local wo
 
 - `src/App.tsx`: composition root
 - `src/components/`: presentational UI components
+- `src/components/SettingsView.tsx`: settings UI (projects, display, Codex)
+- `src/components/UpdateToast.tsx`: in-app updater UI
+- `src/components/Home.tsx`: home dashboard + latest agent runs
 - `src/hooks/`: state + event wiring
+- `src/hooks/useAppSettings.ts`: app settings load/save + doctor
+- `src/hooks/useUpdater.ts`: update checks + install flow
+- `src/hooks/useResizablePanels.ts`: panel resize + persistence
+- `src/hooks/useComposerImages.ts`: image attachment state
+- `src/hooks/useComposerImageDrop.ts`: drag/drop + paste images
+- `src/hooks/useGitHubIssues.ts`: GitHub issues tab data
 - `src/utils/threadItems.ts`: thread item normalization + conversion
 - `src/services/tauri.ts`: Tauri IPC wrapper
 - `src/styles/`: split CSS by area
 - `src/types.ts`: shared types
 - `src-tauri/src/lib.rs`: backend app-server client
+- `src-tauri/src/git.rs`: git status/log/diff + GitHub issues via `gh`
+- `src-tauri/src/settings.rs`: app settings persistence
+- `src-tauri/src/prompts.rs`: custom prompt discovery/parsing
 - `src-tauri/tauri.conf.json`: window config + effects
 
 ## Architecture Guidelines
@@ -73,7 +85,9 @@ to the next minor version.
 - UI layout or styling: update `src/components/*` and `src/styles/*`.
 - App-server event handling: edit `src/hooks/useAppServerEvents.ts`.
 - Tauri IPC: add wrappers in `src/services/tauri.ts` and implement in `src-tauri/src/lib.rs`.
+- App settings or updater behavior: `src/hooks/useAppSettings.ts`, `src/hooks/useUpdater.ts`, and `src/components/SettingsView.tsx`.
 - Git diff behavior: `src/hooks/useGitStatus.ts` (polling + activity refresh) and `src-tauri/src/lib.rs` (libgit2 status).
+- GitHub issues panel: `src/hooks/useGitHubIssues.ts` + `src-tauri/src/git.rs`.
 - Thread history rendering: `src/hooks/useThreads.ts` converts `thread/resume` turns into UI items.
   - Thread names update on first user message (preview-based), and on resume if a preview exists.
 - Thread item parsing/normalization: `src/utils/threadItems.ts`.
@@ -84,3 +98,7 @@ to the next minor version.
 - The window uses `titleBarStyle: "Overlay"` and macOS private APIs for transparency.
 - Avoid breaking the JSON-RPC format; app-server rejects requests before initialization.
 - The debug panel is UI-only; it logs client/server/app-server events from `useAppServerEvents`.
+- App settings live in `settings.json` under the app data directory (Codex path, default access mode, UI scale).
+- UI preferences (panel sizes, reduced transparency toggle, recent thread activity) live in `localStorage`.
+- GitHub issues require `gh` to be installed and authenticated.
+- Custom prompts are loaded from `$CODEX_HOME/prompts` (or `~/.codex/prompts`) and support optional frontmatter metadata.

README.md

@@ -4,30 +4,33 @@
 
 CodexMonitor is a macOS Tauri app for orchestrating multiple Codex agents across local workspaces. It provides a sidebar to manage projects, a home screen for quick actions, and a conversation view backed by the Codex app-server protocol.
 
-## Features (MVP)
-
-- Add and persist workspaces using the system folder picker.
-- Spawn one `codex app-server` per workspace and stream events over JSON-RPC.
-- Restore threads per workspace from the Codex rollout history (`thread/list`) and resume on selection.
-- Start agent threads, send messages, show reasoning/tool call items, and handle approvals.
-- Worktree agents per workspace (create/delete git worktrees under `.codex-worktrees`).
-- Git panel with diff stats, file diffs, and commit log; open commits on GitHub when a remote is detected.
+## Features
+
+- Add and persist workspaces with a home dashboard of recent agent activity.
+- Spawn one `codex app-server` per workspace, stream JSON-RPC events, and resume threads on selection.
+- Start agent threads, send messages, render reasoning/tool/diff items, and handle approvals.
+- Worktree agents per workspace (create/delete git worktrees under `.codex-worktrees`) with quick worktree info.
+- Git panel with diff stats, file diffs, commit log, and GitHub Issues (via `gh`); open commits on GitHub when a remote is detected.
 - Branch list with checkout and create flows.
 - Model picker, reasoning effort selector, access mode (read-only/current/full-access), and context usage ring.
-- Skills menu and composer autocomplete for `$skill`, `/prompts:...`, and `@file` tokens (custom prompts pulled from `~/.codex/prompts`).
-- Plan panel for per-turn planning updates and turn interruption controls.
+- Skills menu and composer autocomplete for `$skill`, `/prompts:...`, `/review ...`, and `@file` tokens.
+- Plan panel for per-turn planning updates plus turn interrupt controls.
 - Review runs against uncommitted changes, base branch, commits, or custom instructions.
-- Debug panel for warning/error events and clipboard export.
+- Debug panel for warning/error events with clipboard export.
 - Sidebar usage + credits meter for account rate limits.
-- Archive threads (removes from UI and calls `thread/archive`).
-- macOS overlay title bar with vibrancy effects.
+- Composer queueing plus image attachments (picker, drag/drop, paste) with per-thread drafts.
+- Resizable sidebar/right/plan/debug panels with persisted sizes.
+- Responsive layouts for desktop/tablet/phone with tabbed navigation.
+- In-app updater with toast-driven download/install.
+- macOS overlay title bar with vibrancy effects and optional reduced transparency.
 
 ## Requirements
 
 - Node.js + npm
 - Rust toolchain (stable)
 - Codex installed on your system and available as `codex` in `PATH`
 - Git CLI (used for worktree operations)
+- GitHub CLI (`gh`) for the Issues panel (optional)
 
 If the `codex` binary is not in `PATH`, update the backend to pass a custom path per workspace.
 
@@ -82,12 +85,15 @@ src-tauri/
 ## Notes
 
 - Workspaces persist to `workspaces.json` under the app data directory.
+- App settings persist to `settings.json` under the app data directory (Codex path, default access mode, UI scale).
 - On launch and on window focus, the app reconnects and refreshes thread lists for each workspace.
 - Threads are restored by filtering `thread/list` results using the workspace `cwd`.
 - Selecting a thread always calls `thread/resume` to refresh messages from disk.
 - CLI sessions appear if their `cwd` matches the workspace path; they are not live-streamed unless resumed.
 - The app uses `codex app-server` over stdio; see `src-tauri/src/lib.rs`.
 - Worktree agents live in `.codex-worktrees/` and are removed on delete; the root repo gets a `.gitignore` entry.
+- UI state (panel sizes, reduced transparency toggle, recent thread activity) is stored in `localStorage`.
+- Custom prompts load from `$CODEX_HOME/prompts` (or `~/.codex/prompts`) with optional frontmatter description/argument hints.
 
 ## Tauri IPC Surface