jmail-gui

Controls the jMail desktop window to compose drafts, navigate threads, and search the inbox.

108|11|Updated Jun 26, 2026
One-click install
npx skills add https://github.com/db-aeon/joshu-oss --skill jmail-gui-db-aeon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jmail-gui
Source: https://github.com/db-aeon/joshu-oss/tree/main/arozos/subservice/jmail/skills/jmail-gui
Command: npx skills add https://github.com/db-aeon/joshu-oss --skill jmail-gui-db-aeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When the jMail desktop app is open, the agent needs to act on the on-screen inbox rather than calling external mail APIs blindly. This Skill defines how to read the GUI snapshot, drive in-app actions, and handle voice commands without duplicating or conflicting with the user's view. ## Core Features & Use Cases - GUI-first mail reading: Reads inboxPreview and openThread from the injected GUI snapshot to answer inbox questions, falling back to refreshInbox when the snapshot is empty. - In-app actions via app_gui_action: Opens compose drafts, threads, search, inbox switching, and mirror sync directly in the jMail window. - Voice fast paths: Maps spoken commands like "new email" or "search mail for ..." to manifest-defined guiActions for low-latency voice interaction. - Use Case: A user says "draft a reply to Sarah about the meeting" while jMail is open; the agent calls openCompose with the to, subject, and body fields so the user can review and send the draft in the UI. ## Quick Start With the jMail window open, ask the agent to draft an email to a specific recipient with a subject and body, and it will open the compose pane with the draft filled in.

Frequently Asked Questions about jmail-gui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I draft an email in the jMail desktop app with the agent?

Ask the agent to compose a message while jMail is open. It calls app_gui_action with the openCompose action and the to, subject, and body fields, opening the compose pane with your draft. The agent never sends mail; you send it from the UI.

How does the agent answer questions about my inbox in jMail?

The agent reads the inboxPreview and openThread fields from the injected GUI snapshot, which mirrors what you see on screen. If the snapshot is empty or you ask for a refresh, it triggers the refreshInbox action and uses the returned subject list.

When does the agent use Gmail APIs instead of the jMail GUI?

Only when the mail is outside the loaded list, in another account, in the deep archive, or when you explicitly ask to search live Gmail. In those cases it follows the joshu-mail search order: gbrain, then the local mirror, then Composio live Gmail.

Can I use voice commands to search or compose mail in jMail?

Yes. When jMail is open, voice tools are built from the manifest's guiActions voice entries. Saying "new email" or "search mail for ..." maps to app_jmail_compose or app_jmail_search, which invoke the openCompose and searchMail actions.

Can the agent send emails directly from jMail?

No. The skill explicitly forbids sending mail. The agent only creates drafts through the openCompose action, and the user reviews and sends the message in the jMail UI.