Agent skill

Zele

by remorses in remorses/zele

zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.

No licenceAuto-check passedProductivity & Automation

Install Zele

skills CLI
$ npx skills add remorses/zele --skill zele -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install remorses/zele zele --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/remorses/zele.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/zele .claude/skills/zele && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
zele
GitHub stars
299
Token cost
~1.5k tokens
SKILL.md length
602 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.

  • Works in 11 steps: Never use the TUI. Running zele with no… → Always run zele whoami first when the… → Never truncate --help or README output… → …
  • Asks to check email
  • Calls yq and curl
  • Read/send messages

What it does

Zele is an agent skill from remorses/zele. zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar. It reads, searches, sends, replies, forwards, archives, stars, and trashes emails, manages drafts, labels, attachments, and Gmail filters, and creates, updates, and deletes calendar events with RSVP and free/busy support. Output is YAML so commands can be piped through yq and xargs. ALWAYS load this skill when the user asks to check email, read/send messages, reply or forward, archive or…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Email management, Calendar and scheduling and Transactional email. It works with Gmail and Google Calendar. The repository describes itself as: Email & Calendar CLI. Gmail, Outlook, IMAP/SMTP and Google Calendar from your terminal. For humans & agents.

When your agent uses it

  • Asks to check email
  • Read/send messages
  • Download attachments
  • Schedule meetings

Example prompts

  • “/zele”

Workflow steps

11 steps, taken from the first numbered list in SKILL.md.

  1. Never use the TUI. Running zele with no subcommand launches a human-facing TUI. Agents must use the CLI subcommands (zele mail list, zele…
  2. Always run zele whoami first when the user asks to operate on a specific account. Pick the exact email from the output and pass it with…
  3. Never truncate --help or README output with head, tail, sed, awk, or less. Critical rules are spread throughout. Read them in full.
  4. Parse YAML output with yq, not regex. Pipe IDs through xargs for bulk actions. Always use --limit 100 (or higher) so you don't miss threads
  5. Google-only features (labels, Gmail filters, zele cal *, full profile) fail on IMAP accounts with a clear error. Check zele whoami output…
  6. Headless Google login requires a tmux wrapper because zele login is interactive. See the README "Remote / headless login" section for the…
  7. Waiting for emails with zele mail watch. It polls for new emails matching a filter and exits as soon as one arrives. Use this to wait for…
  8. Check reply recipients before sending with zele mail reply --dry-run. Recipients are inferred from the thread, not from the sender of the…
  9. Read a thread before replying. zele mail reply and zele mail send --thread-id fail with UnseenLatestError unless zele mail read already…
  10. Send into an existing thread with zele mail send --thread-id when you need full control of recipients and subject but still want correct…
  11. Format email bodies like a human wrote them. These rules apply to --body and to every draft you show the user for approval

What it can do on your machine

Read from SKILL.md and the folder at commit 4075562. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • yq
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Zele loads about 1.5k tokens when it runs. Until then it costs about 219 tokens; SKILL.md has 602 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~219
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 602 words (~1,519 tokens).

“Every time you use zele, you MUST fetch the latest README:”

— opening of SKILL.md by remorses
name
zele

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/zele of remorses/zele.

Open the folder on GitHubat commit 4075562

Compare with similar skills

Zele next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Zele compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Zele this skillremorses/zele299—~1.5kAutomated safety check: PassNone
Composio Cloud Toolsquarqlabs/argus277—~543Automated safety check: PassApache-2.0
Google Workspaceericrisco/rsc-harness167—~3.2kAutomated safety check: PassMIT
Gmail Emailopen-gitagent/gitagent710—~235Automated safety check: NotesMIT
Google Workspaceyc-software/qm15k—~1.8kAutomated safety check: PassMIT
Canonical SchemaNxcoreAI/EverRoom3k—~895Automated safety check: PassCustom licence

Similar skills

  • Composio Cloud Tools

    quarqlabs/argus

    Routes requests to external SaaS apps such as GitHub, Gmail, Google Calendar, Slack, Notion and Linear through cloud tools, with safeguards on irreversible actions.

    277 GitHub stars~543 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Google Workspace

    ericrisco/rsc-harness

    A skill your agent uses when server-side code reads or writes Gmail, Drive, Calendar, or Sheets with a GCP service account and no human in the OAuth loop: picking the auth mode (app-owned vs…

    167 GitHub stars~3.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Gmail Email

    open-gitagent/gitagent

    Send emails via Gmail SMTP using App Password authentication.

    710 GitHub stars~235 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Google Workspace

    yc-software/qm

    Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.

    15k GitHub stars~1.8k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Canonical Schema

    NxcoreAI/EverRoom

    canonical schema 字段语义与各 provider 原始格式要点(gmail/outlook/google-calendar)。产出格式映射时使用。

    3k GitHub stars~895 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Inbox Placement Monitor

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "track where my emails are actually landing after I send", "read my seed-list inbox vs spam vs promotions results", "trend my Gmail Postmaster /…

    2.9k GitHub starsUsed in 2 repos~3.6k tokens
    Productivity & AutomationAuto-check passed

Questions about Zele

What does Zele do?

zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar. Zele is an agent skill from remorses/zele. zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.

When should I use Zele?

Zele fits situations like: asks to check email; read/send messages; download attachments; schedule meetings.

How do I install Zele in Claude Code?

Run `npx skills add remorses/zele --skill zele -a claude-code`. Or copy the skill folder (skills/zele in remorses/zele) into .claude/skills/zele in your project. Claude Code loads it when a task matches its description.

How do I install Zele in Codex?

Run `npx skills add remorses/zele --skill zele -a codex`. Or copy the skill folder (skills/zele in remorses/zele) into .agents/skills/zele in your project. Codex loads it when a task matches its description.

Can I use Zele in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add remorses/zele --skill zele -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zele, .gemini/skills/zele, .github/skills/zele and .opencode/skills/zele in your project.

What does Zele need to run?

Going by SKILL.md and its folder, Zele needs the command-line tools its instructions call (yq and curl).

Does Zele access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Zele safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Zele use?

No licence was found for Zele or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Zele use?

About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Zele?

Skills that share tags, products or a category with Zele: Composio Cloud Tools (quarqlabs/argus, 277 stars), Google Workspace (ericrisco/rsc-harness, 167 stars), Gmail Email (open-gitagent/gitagent, 710 stars) and Google Workspace (yc-software/qm, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zele?

remorses (a GitHub user) maintains it in remorses/zele, which has 299 GitHub stars. The repository was last updated on October 7, 2026.

Source: remorses/zele on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.