akiiwa-games/AgentCompass / skills/gemini-web
gemini-web
VerifiedRun Gemini web work through AgentCompass's signed-in Gemini Web Chrome (CDP 127.0.0.1:17849), including Gemini Omni 1.1 Flash (gemini-omni-1.1-flash) video generation and video-to-video editing in Google AI Studio with role-tagged source and reference media. Use when a task needs Gemini, AI Studio, Flow or Omni 1.1 through the browser rather than an API key.
Gemini Web
AgentCompass keeps one Google Chrome signed in to the user's Google account for Gemini work:
<AgentCompass>/gemini-web/ (gemini-web/README.md).
The tray's Gemini line opens its window. This is a local tool that runs in the calling agent.
It is not a worker and launches nothing. A delegated task that uses it must run on this machine:
pass --local-only "Gemini Web browser on this machine" to the router.
Check
python -X utf8 gemini-web/omni.py status
gemini_web.health is null while the browser is stopped. run starts it, so a stopped browser
is fine.
Omni 1.1 video (AI Studio)
python -X utf8 gemini-web/omni.py run `
--video <source.mp4> --image-ref <style1.png> --image-ref <style2.png> `
--prompt-file <prompt.txt> --resolution 720p --aspect-ratio 16:9 --out <new run dir>
- Inputs:
--videois the clip to edit (≤10 s).--extend-videocontinues a clip.--first-frame,--last-frameand--loop-frameare keyframes.--image-reftakes up to 6 images;--video-reftakes up to 3 clips of ≤3 s.- The prompt may refer to
<VIDEO_0>,<IMAGE_REF_0>and so on; the runner prepends Omni's[# Sources ...] [# References ...]tags.
- Check before sending: run
packetwith the same arguments to see the composed prompt without sending it. Or userun --prepare-only, which fills AI Studio and stops before Run. - Results:
<out>/state.jsonand<out>/output.mp4. Reportconversation_urlfromstate.jsonas evidence of the run. - Duration defaults to the source length (3–10 s);
--durationoverrides it.
When status is not completed, stop and tell the user. These are theirs to resolve:
login_required: the user signs in once in the Gemini Web window.consent_requiredanddrive_required: one-time AI Studio account decisions (the media acknowledgement and Enable Google Drive). Only the account owner clicks them. Never click them for the user.model_errorortimeout_or_pending: the tab is left open in front. Readfinal_page.pngandaistudio_dom.json, and retry at most once with a new--out.
Other Gemini pages
Attach with gemini_web.new_task_page(playwright, url). This needs sys.path to include the
gemini-web directory; use one new tab per task. Close your tab and never the browser.
python -X utf8 gemini-web/gemini_web.py show gemini|aistudio|flow
gemini.google.com/videos accepts images only. Video-to-video goes through AI Studio.
Rules
- Transport: this browser only. No external proxy, no API key, no other Chrome profile.
- No system dialogs:
- Upload with
set_input_filesand read results inside the page. - Never click a download, export or "Save as" control.
- Never collect
*.tmpor*.crdownloadfiles from Downloads.
- Upload with
- Never overwrite outputs. Give every run a new
--out. The runner refuses a directory that already hasoutput.mp4. - Prompts: describe a visual style in plain terms (palette, outline, shading, resolution), not by the name of a commercial game or show, which can trip the content classifier.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |