القائمة
Develops and maintains the fastmail-cli project. Use when adding commands, fixing bugs, or modifying the CLI codebase.
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/aliou/fastmail-cli --skill developing-fastmail-cliيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | developing-fastmail-cli |
| description | Develops and maintains the fastmail-cli project. Use when adding commands, fixing bugs, or modifying the CLI codebase. |
A CLI for FastMail built with Bun + TypeScript, using the JMAP protocol against https://api.fastmail.com/jmap/session.
bun run src/index.ts <command> <subcommand> [flags]
bun run typecheck # type checking
bun run lint # lint (biome)
bun run format # auto-fix formatting
bun run test # tests
bun run build # compile binaries for all platforms
src/index.ts - Entry point. Routes commands to handler functions. Uses .js import extensions for dynamic imports.src/cli.ts - Top-level arg parsing, help text, shell completions (bash/zsh/fish).src/jmap/client.ts - JmapClient class handling session discovery, request batching, and response parsing.src/jmap/types.ts - JMAP protocol types and capability constants.src/jmap/*.ts - JMAP method wrappers per resource (email, mailbox, masked-email, thread, blob, submission).src/args.ts - Shared parseArgs() helper wrapping node:util parseArgs. Provides wantsHelp(), getString(), getNumber(), getBoolean(), getPositional().src/config.ts - Config loading/saving. Global config at ~/.config/fastmail-cli/config.json with 0600 permissions. getApiToken() checks env var FASTMAIL_API_TOKEN first, then config file.src/auth.ts - Auth functions: login(), logout(), getAuthStatus(), readTokenFromStdin(), promptForToken(). Validates tokens via JMAP session fetch.src/constants.ts - APP_NAME, VERSION, JMAP_SESSION_URL, CONFIG_FILE.src/commands/ - One file per command resource. Each exports named handler functions.src/jmap/<resource>.ts.src/commands/<resource>.ts.../args.ts.listX, getX, createX, etc.) that take args: string[].wantsHelp(), get token via getApiToken(), create JmapClient, make JMAP calls, format output.src/index.ts with dynamic import using .js extension.main().printHelp() in src/cli.ts.src/cli.ts (bash, zsh, fish).src/commands/<resource>.test.ts using bun:test with bun-bagel for mocking..ts import extensions internally. src/index.ts uses .js extensions for dynamic imports.--help and --json flags.FASTMAIL_API_TOKEN env var > config file.JmapClient from src/jmap/client.ts for all API calls.parseArgs() from src/args.ts for argument parsing with named option definitions.console.error, exit with process.exit(1).bun:test with bun-bagel for HTTP mocking. Colocated as *.test.ts.bun-bagel. No real API calls in tests.bunx changeset to create a changeset.bun run version runs changeset version, builds binaries, computes nix hashes, updates flake.nix and src/constants.ts.bun-darwin-arm64, bun-linux-arm64, bun-linux-x64.When modifying commands, these files often need updates together:
src/jmap/<resource>.ts - JMAP method wrapperssrc/commands/<resource>.ts - Command implementationsrc/commands/<resource>.test.ts - Testssrc/index.ts - Command routingsrc/cli.ts - Help text and shell completions