Agent Instructions
# AGENTS.md instructions for /Users/henrymascot/Code/entity
<INSTRUCTIONS>
## Skills
A skill is a set of local instructions to follow that is stored in a `SKILL.md` file. Below is the list of skills that can be used. Each entry includes a name, description, and file path so you can open the source for full instructions when using a specific skill.
### Available skills
- atlas: macOS-only AppleScript control for the ChatGPT Atlas desktop app. Use only when the user explicitly asks to control Atlas tabs/bookmarks/history on macOS and the "ChatGPT Atlas" app is installed; do not trigger for general browser tasks or non-macOS environments. (file: /Users/henrymascot/.agents/skills/atlas/SKILL.md)
- frontend-design: Expert frontend design guidelines for creating beautiful, modern UIs. Use when building landing pages, dashboards, or any user interface. (file: /Users/henrymascot/.agents/skills/frontend-design/SKILL.md)
- humanizer: Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. (file: /Users/henrymascot/.agents/skills/humanizer/SKILL.md)
- planner: Create structured plans for multi-task projects that can be executed by the task-orchestrator skill. Use when breaking down complex work into parallel/sequential tasks with dependencies. (file: /Users/henrymascot/.agents/skills/planner/SKILL.md)
- planning-with-files: Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage. Use when starting complex tasks, multi-step projects, research tasks, or when the user mentions planning, organizing work, tracking progress, or wants structured output. (file: /Users/henrymascot/.agents/skills/planning-with-files/SKILL.md)
- senior-engineering: Engineering principles for building software like a senior engineer. Load when tackling non-trivial development work, architecting systems, reviewing code, or orchestrating multi-agent builds. Covers planning, execution, quality gates, and LLM-specific patterns. (file: /Users/henrymascot/.agents/skills/senior-engineering/SKILL.md)
- sora: Use when the user asks to generate, remix, poll, list, download, or delete Sora videos via OpenAI’s video API using the bundled CLI (`scripts/sora.py`), including requests like “generate AI video,” “Sora,” “video remix,” “download video/thumbnail/spritesheet,” and batch video generation; requires `OPENAI_API_KEY` and Sora API access. (file: /Users/henrymascot/.agents/skills/sora/SKILL.md)
- spreadsheet: Use when tasks involve creating, editing, analyzing, or formatting spreadsheets (`.xlsx`, `.csv`, `.tsv`) using Python (`openpyxl`, `pandas`), especially when formulas, references, and formatting need to be preserved and verified. (file: /Users/henrymascot/.agents/skills/spreadsheet/SKILL.md)
- vercel-deploy: Deploy applications and websites to Vercel using the bundled `scripts/deploy.sh` claimable-preview flow. Use when the user asks to deploy to Vercel, wants a preview URL, or says to push a project live on Vercel. (file: /Users/henrymascot/.agents/skills/vercel-deploy/SKILL.md)
- web-design-guidelines: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices". (file: /Users/henrymascot/.agents/skills/web-design-guidelines/SKILL.md)
- skill-creator: Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations. (file: /Users/henrymascot/.agents/skills/.system/skill-creator/SKILL.md)
- skill-installer: Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos). (file: /Users/henrymascot/.agents/skills/.system/skill-installer/SKILL.md)
### How to use skills
- Discovery: The list above is the skills available in this session (name + description + file path). Skill bodies live on disk at the listed paths.
- Trigger rules: If the user names a skill (with `$SkillName` or plain text) OR the task clearly matches a skill's description shown above, you must use that skill for that turn. Multiple mentions mean use them all. Do not carry skills across turns unless re-mentioned.
- Missing/blocked: If a named skill isn't in the list or the path can't be read, say so briefly and continue with the best fallback.
- How to use a skill (progressive disclosure):
1) After deciding to use a skill, open its `SKILL.md`. Read only enough to follow the workflow.
2) When `SKILL.md` references relative paths (e.g., `scripts/foo.py`), resolve them relative to the skill directory listed above first, and only consider other paths if needed.
3) If `SKILL.md` points to extra folders such as `references/`, load only the specific files needed for the request; don't bulk-load everything.
4) If `scripts/` exist, prefer running or patching them instead of retyping large code blocks.
5) If `assets/` or templates exist, reuse them instead of recreating from scratch.
- Coordination and sequencing:
- If multiple skills apply, choose the minimal set that covers the request and state the order you'll use them.
- Announce which skill(s) you're using and why (one short line). If you skip an obvious skill, say why.
- Context hygiene:
- Keep context small: summarize long sections instead of pasting them; only load extra files when needed.
- Avoid deep reference-chasing: prefer opening only files directly linked from `SKILL.md` unless you're blocked.
- When variants exist (frameworks, providers, domains), pick only the relevant reference file(s) and note that choice.
- Safety and fallback: If a skill can't be applied cleanly (missing files, unclear instructions), state the issue, pick the next-best approach, and continue.
</INSTRUCTIONS>Planning app-wide login overlay
Served.
http://127.0.0.1:5173http://127.0.0.1:3001ws://127.0.0.1:3002I verified listeners are active on all three ports.
Served.
http://127.0.0.1:5173http://127.0.0.1:3001ws://127.0.0.1:3002I verified listeners are active on all three ports.
not working
Troubleshooting remote access issues
I’m diagnosing live now. I’ll verify the running dev sessions, then restart the frontend bound to 0.0.0.0 so it’s reachable from both localhost and your network/Tailscale URL.
I’m diagnosing live now. I’ll verify the running dev sessions, then restart the frontend bound to 0.0.0.0 so it’s reachable from both localhost and your network/Tailscale URL.
I understand: you want authentication moved from the Tasks/Mission Control section to the entire app, plus a Settings modal toggle to enable/disable login globally. I’m going to read the context file first, then inspect existing login/settings code so I can wire this cleanly.
Assessing background session persistence
Both dev processes had exited, so that’s why it failed. I’m starting them again right now and binding the app to 0.0.0.0 so your localhost and Tailscale URL both work.
Checking operational status
I understand: you want authentication moved from the Tasks/Mission Control section to the entire app, plus a Settings modal toggle to enable/disable login globally. I’m going to read the context file first, then inspect existing login/settings code so I can wire this cleanly.
Checking temporary log files
Planning escalation for background processes
The sandbox is dropping background jobs. I’m restarting both processes with escalated execution so they stay up and are reachable.
Planning log inspection
Checking local URL availability
Preparing final troubleshooting advice
Fixed. It’s running now.
Use one of these URLs:
http://localhost:5173http://100.86.150.96:5173http://192.168.86.168:5173Confirmed listeners:
*:5173*:3001*:3002If it still doesn’t load, make sure you’re using http:// (not https://) and hard refresh once.
Fixed. It’s running now.
Use one of these URLs:
http://localhost:5173http://100.86.150.96:5173http://192.168.86.168:5173Confirmed listeners:
*:5173*:3001*:3002If it still doesn’t load, make sure you’re using http:// (not https://) and hard refresh once.
test with agentbrowser
Planning agent-browser smoke test
Running an agent-browser smoke test now against http://127.0.0.1:5173: I’ll validate load, nav switching, task board content, and capture a screenshot as proof.
Planning server restart and session check
The app port is down again, so I’ll restart both dev servers and re-run the agent-browser test immediately.
Running agent-browser tests
Servers are back up. I’m executing the full agent-browser smoke flow now and collecting pass/fail outputs.
Refining navigation button text checks
Preparing to attach screenshot
Agent-browser test passed.
Results:
http://127.0.0.1:5173localStorage set + reload)taskNodes: 18backlogHeader: Backlog (13)Ops, StrategicActivity StreamEvidence screenshot:
artifacts/agentbrowser-smoke.pngIf you want, I can also run a second smoke on the network URL (http://100.86.150.96:5173) to confirm remote accessibility specifically.
test again and send me a screenshot
test again and send me a screenshot
Planning test run with screenshot
Running another end-to-end agent-browser pass now and capturing a fresh screenshot for you. I’ll verify the page loads, open Tasks, then send the new image.
Running another end-to-end agent-browser pass now and capturing a fresh screenshot for you. I’ll verify the page loads, open Tasks, then send the new image.
Planning escalated server restart
Ports are currently not listening, so I’m starting both app and server first, then running the test immediately.
Running browser test with screenshot
Servers are up. I’m running the second agent-browser smoke flow now and capturing a fresh screenshot file.
Inspecting context directory
Polling for screenshot completion
Verifying file existence and previewing image
Gathering project metadata
I’m using the senior-engineering skill for this change because it touches app-wide auth flow, state persistence, and UI integration across multiple views. I found a .context directory, so next I’m reading it and the Mission Control login/settings code paths.
Retested with agent-browser and captured a fresh screenshot.
artifacts/agentbrowser-smoke-2.png1536x960Tasks → captureThe UI is loading and the task board is rendering with populated columns.
<image name=[Image #1]> [Image #1] Too many wards there, especially if the tabs are not moving. The MacDown reader is not working anymore. If I select on a document, nothing happens. Then as you can see um this showing error. I mean it came up now I clicked a couple of times. You had error on retry, retreating, retry, retry, click a couple of times, but it's back now I don't need s we don't need to see the context through. Just remove that. That's some extra t text. In the setting there was um in the setting there was this um in the original setting on the the taskbar there's this thing where you could click to toggle on archives. Please add it back add a sample add a sample add a few sample of um cards into the into the database so that we can click on the card and see the view of how a card looks because we need to be able to edit the details inside a a card, a task card.
[Image #1] Too many wards there, especially if the tabs are not moving. The MacDown reader is not working anymore. If I select on a document, nothing happens. Then as you can see um this showing error. I mean it came up now I clicked a couple of times. You had error on retry, retreating, retry, retry, click a couple of times, but it's back now I don't need s we don't need to see the context through. Just remove that. That's some extra t text. In the setting there was um in the setting there was this um in the original setting on the the taskbar there's this thing where you could click to toggle on archives. Please add it back add a sample add a sample add a few sample of um cards into the into the database so that we can click on the card and see the view of how a card looks because we need to be able to edit the details inside a a card, a task card.
Planning fixes for file tree, context rail, and settings
I’ll fix this in three parts: restore reliable file loading/preview, simplify the left rail text, and add the archive toggle back in Settings. After that I’ll seed sample tasks into the DB so you can open/edit task detail cards immediately.
Inspecting HTTP helper and Archive toggle
I found the root issue for the file panel: FileTree still uses a hardcoded plain fetch path and no fallback logic. I’m patching it to use resilient API fallback (same pattern as tasks), then I’ll simplify the left rail labels and restore the archive toggle in settings.
Planning multi-part UI and backend updates
I’m implementing the reliability fix first: FileTree will now use API fallback candidates (including direct :3001 fallback), so the file list and document selection work even when proxy behavior is inconsistent.
Planning context rail and archive toggle
Next I’m removing the extra left-rail wording/chips and wiring back the Archive-column setting in your main Settings modal (including persistence and runtime apply).
Adding state management
Adding persistence to login effects
Planning callback insertion
Adding effect dependency for state update
Refactoring visibility toggle handling
Adding archive toggle to settings modal
Adding API fallback for file fetch/save
I’m also patching file open/save requests in App.tsx to use the same fallback strategy, so clicking a document reliably loads Markdown even if /api proxy path fails.
Patching file save and fetch calls
Removing mobile condition for effect
Adding sample task seeding
I’m adding a safe startup seed on the server side so sample editable tasks are always present (idempotent, no duplicates by name).
I’m adding a safe startup seed on the server side so sample editable tasks are always present (idempotent, no duplicates by name).
Planning build and restart checks
I’ve applied all requested code changes. I’m running build checks now, then I’ll restart the server (to apply sample-task seeding) and run agent-browser to verify: file selection works, context text is removed, archive toggle exists, and sample cards are clickable.
Restarting session with escalation
Planning UI and data verification
I’m running a focused browser verification now for your exact concerns: no “Context Rail” text clutter, file tree loads without fetch error, file click opens preview, archive toggle appears in Settings, and sample tasks exist.
Analyzing missing settings text issue
One requested piece is still missing: task detail editing from card click. The sample cards are present, but we should confirm click opens detail and fields are editable; I’m running that check now and patching if needed.
Implemented and verified.
What I changed:
packages/app/src/components/FileTree.tsxpackages/app/src/App.tsx:3001) so file list and markdown open work consistently.Context Rail / Active Context / Pinned / Shortcuts / Recent labels from rail shell in packages/app/src/App.tsx.Show archive column toggle in packages/app/src/App.tsx.localStorage key mc_showArchive.setArchiveVisibility(...).packages/server/src/index.ts with ensureSampleTasks().Sample: Product brief reviewSample: QA regression checklistSample: Weekly planning syncVerification (agent-browser):
Context Rail label clutter: confirmed.Failed to fetch in left file panel: confirmed.PRD.md, preview loaded.taskCount: 21, sample names found).detailOpen: true, editableFields: 35, #detailTaskName present.Screenshots:
artifacts/fixes-verification.pngartifacts/detail-check-2.pngIf you want, I can do one final micro-polish pass on spacing in the left rail so file view feels less cramped on smaller heights.
Implemented and verified.
What I changed:
packages/app/src/components/FileTree.tsxpackages/app/src/App.tsx:3001) so file list and markdown open work consistently.Context Rail / Active Context / Pinned / Shortcuts / Recent labels from rail shell in packages/app/src/App.tsx.Show archive column toggle in packages/app/src/App.tsx.localStorage key mc_showArchive.setArchiveVisibility(...).packages/server/src/index.ts with ensureSampleTasks().Sample: Product brief reviewSample: QA regression checklistSample: Weekly planning syncVerification (agent-browser):
Context Rail label clutter: confirmed.Failed to fetch in left file panel: confirmed.PRD.md, preview loaded.taskCount: 21, sample names found).detailOpen: true, editableFields: 35, #detailTaskName present.Screenshots:
artifacts/fixes-verification.pngartifacts/detail-check-2.pngIf you want, I can do one final micro-polish pass on spacing in the left rail so file view feels less cramped on smaller heights.
/Users/henrymascot/Pictures/Screenshots/Screenshot\ 2026-02-07\ at\ 6.33.25 PM.png /Users/henrymascot/Pictures/Screenshots/Screenshot\ 2026-02-07\ at\ 6.33.30 PM.png Can you um fix the UI um so that it's it's as simple and minimalistic and as beautiful as um the output that you've done?
Surveying context and login overlay
/Users/henrymascot/Pictures/Screenshots/Screenshot\ 2026-02-07\ at\ 6.33.25 PM.png /Users/henrymascot/Pictures/Screenshots/Screenshot\ 2026-02-07\ at\ 6.33.30 PM.png Can you um fix the UI um so that it's it's as simple and minimalistic and as beautiful as um the output that you've done?
Preparing to view screenshots
I’ll use the frontend-design skill and tune the actual shell to match the cleaner mock: fewer labels, tighter hierarchy, and calmer controls. First I’m opening your two screenshots to align precisely with what you’re seeing.
I’ll use the frontend-design skill and tune the actual shell to match the cleaner mock: fewer labels, tighter hierarchy, and calmer controls. First I’m opening your two screenshots to align precisely with what you’re seeing.
Inspecting detail panel markup