esa
esa CLI skill for AI agents - search, read, create, and manage esa posts via CLI
Open source Open in the app JSON README (API)
About
esa CLI skill for AI agents - search, read, create, and manage esa posts via CLI
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- esaio
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Stars
- 5
- Last push
- 2026-09-07T08:14:40Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
esaio/esa-skills
README
[日本語](README.ja.md) # esa Skills A collection of skills for operating [esa](https://esa.io) from AI agents. ## Overview esa Skills provides skills that let AI agents operate your esa team directly. With natural language instructions, you can search, read, create, and edit posts, post comments, browse categories and tags, and manage attachments — all through the [esa CLI](https://www.npmjs.com/package/@esaio/esa-cli). ## Skills ### esa-cli A skill that enables AI agents to operate esa through the esa CLI. #### Features - **Posts** — Search, view, create, update, append/prepend, duplicate, rollback, archive, delete - **Comments** — List, view, create, update, delete - **Categories** — List paths - **Tags / Members / Team** — List, stats - **Attachments** — Upload, sign, download - **Feedback** — Send feedback to the esa.io team - **Escape hatch** — Call any esa API path via `esa api` #### Usage Examples ``` "Search esa for meeting notes" "Show me post 1234" "Post today's work log as a WIP to esa" "Add a comment to post 1234" "List all tags on esa" ``` ## Prerequisites - Claude Code, Cursor, Gemini CLI, or Codex CLI installed - Node.js >= 24.18.0 / npm >= 11.7.0 - [esa CLI](https://www.npmjs.com/package/@esaio/esa-cli) (`@esaio/esa-cli`) installed - Authenticated with the esa CLI (`esa auth login`) ### Install the esa CLI ```bash npm install --ignore-scripts -g @esaio/esa-cli ``` ### Authentication ```bash esa auth login ``` By default this requests every scope the esa CLI commands use. To narrow it down — read-only access, for example — pass `--scopes`. Commands that need a scope you did not grant will fail, so log in again when that happens. ```bash esa auth login --scopes "read:post read:comment" ``` ## Installation ### Claude Code ``` claude plugin marketplace add https://github.com/esaio/esa-skills claude plugin install esa@esa-skills ``` ### Codex CLI ```bash codex plugin marketplace add https://github.com/esaio/esa-skills codex plugin add esa@esa-skills ``` ### Cursor Agent ```bash cursor-agent plugin marketplace add https://github.com/esaio/esa-skills ``` Then start `cursor-agent` in interactive mode, open `/plugin`, and install esa from the Marketplace. ### Gemini CLI ```bash gemini extensions install https://github.com/esaio/esa-skills ``` ### Any agent (GitHub CLI) The `gh skill` command installs Agent Skills from GitHub repositories into the appropriate directory for each supported agent. ```bash # Install for Codex at user scope gh skill install esaio/esa-skills esa-cli --agent codex --scope user # --agent also accepts claude-code, cursor, gemini-cli, and others ``` `gh skill` is a preview feature, so its commands and behavior may change. ### Any agent (npx skills) [`npx skills`](https://github.com/vercel-labs/skills) is a cross-agent skills package manager. It installs the `esa-cli` skill into every coding agent it detects with a single command — handy when you use more than one agent, or one not listed above. ```bash # Install into all detected agents (project-local) npx skills add esaio/esa-skills # Target a specific agent npx skills add esaio/esa-skills --agent claude-code # Install for all your projects npx skills add esaio/esa-skills --global ``` ## Author [esa LLC](https://esa.io) ## License MIT