메뉴
Automate browser portals in Maestri — navigate pages, click elements, fill forms, take screenshots, and read the accessibility tree. Use when working with web portals, testing web UIs, or when the user asks to interact with a browser.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | maestri-portal |
| description | Automate browser portals in Maestri — navigate pages, click elements, fill forms, take screenshots, and read the accessibility tree. Use when working with web portals, testing web UIs, or when the user asks to interact with a browser. |
| user-invocable | false |
Portals are embedded browser nodes on the Maestri canvas. You can automate them to navigate pages, click elements, fill forms, take screenshots, and inspect the DOM — all without requiring window focus.
Portal name is always required. Run maestri list to see connected portal names.
maestri portal create URL ["Name"] — create a new portal on the canvas, open it at the given URL, and automatically connect it to your terminal. The portal appears to the right of your terminal. An optional name can be provided; if omitted it defaults to "Portal".
maestri portal create http://localhost:3000
maestri portal create https://example.com "Docs"
After creating, run maestri list to confirm the portal name, then use it with all other portal commands.
maestri portal edit "Portal" --url URL — point a connected portal at a new URL.
maestri portal edit "Preview" --url http://localhost:5173
The snapshot command is the most important — it returns an accessibility tree with refs (@e1, @e2...) that you can use as selectors for all other commands:
maestri portal snapshot "Portal"
Returns something like:
viewport: 780x520 url: https://example.com title: Example
@e1 a "Home" [10,5 60x20]
@e2 input type=text "Search" [200,50 300x32] *focused*
@e3 button "Submit" [510,50 80x32]
@e4 a "Sign In" href=https://example.com/login [700,5 60x20]
Selectors — all commands that take a selector accept:
@e3 — ref from snapshot (most reliable)#submit — CSS selector350,200 — x,y coordinatesmaestri portal navigate "Portal" "url" — go to URLmaestri portal info "Portal" — get current URL, title, viewport sizemaestri portal screenshot "Portal" — capture screenshot (returns temp file path)maestri portal click "Portal" @e3 — click elementmaestri portal fill "Portal" @e2 "test@example.com" — clear input and set valuemaestri portal type "Portal" @e2 "hello" — append text to input (or type into focused element: type "Portal" "hello")maestri portal key "Portal" "Enter" — press key (Enter, Tab, Escape, Backspace, ArrowUp/Down/Left/Right, Space)maestri portal key "Portal" "ctrl+a" — key with modifiers (ctrl, cmd, shift, alt — e.g. ctrl+a, cmd+c, shift+tab)maestri portal selectall "Portal" — select all text in focused element (or specify selector: selectall "Portal" @e2)maestri portal clear "Portal" — clear focused input (or specify selector: clear "Portal" @e2)maestri portal hover "Portal" @e3 — hover over elementmaestri portal focus "Portal" @e2 — focus elementmaestri portal select "Portal" @e5 "Option Text" — select dropdown optionmaestri portal check "Portal" @e6 / uncheck — toggle checkboxmaestri portal scroll "Portal" down 300 — scroll down 300px from viewport center (up/down/left/right)maestri portal scroll "Portal" down 300 400,250 — scroll the container under point (400,250)maestri portal scroll "Portal" down 300 @e5 — scroll the container under element @e5maestri portal scrollintoview "Portal" @e10 — scroll element into viewmaestri portal snapshot "Portal" — accessibility tree with refs (best for understanding page structure)maestri portal text "Portal" @e1 — get text content of elementmaestri portal html "Portal" — get full page HTMLmaestri portal evaluate "Portal" "document.title" — evaluate JavaScriptmaestri portal logs-start "Portal" — start capturing console output (call once after navigate)maestri portal logs "Portal" — get captured console logs (clears buffer)maestri portal snapshot "Portal" — understand the page structure and get refsclick @e3, fill @e2 "value", key "Enter"maestri portal snapshot "Portal" again to verify resultUse screenshot when you need to see the visual layout. Use snapshot when you need to understand interactive elements. Prefer snapshot + refs over screenshot + coordinates — refs are more accurate.
If a page opens a popup (e.g. an OAuth login), it appears in maestri list as a new portal named [Parent] #2. Target it by name like any other portal. Popups close automatically when the site is done with them.
Edit, apply, and add files in Jay's chezmoi-managed dotfiles. Use when user wants to change shell config, zshrc, aliases, nvim config, tmux, or any file under ~/.config that's tracked by chezmoi.
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
Query local Amie.app meeting recordings and transcripts from the macOS SQLite database. Use this skill whenever you need to retrieve meeting context, action items, summaries, or transcripts from Amie. Triggers on requests like "get my latest meeting", "find recordings from last week", "search transcripts for X", or any question about recorded meetings.