Irasutoya Search

irasutoya-cli

Languages: English | 日本語 | 中文 | 한국어

Claude Code / Codex Installation

This repository is a Claude Code plugin marketplace and also ships standalone Claude and Codex skills. All of them run the real irasutoya CLI search wrapper. Project skills live under .claude/skills/<skill-name>/SKILL.md and plugin skills under <plugin>/skills/<skill-name>/SKILL.md, matching the Claude Code skills and plugins documentation. Pick the path that fits your workflow.

Claude Plugin — Marketplace (recommended)

This is the standard way to install a Claude Code plugin. Add the repository as a marketplace, then install the plugin from it:

/plugin marketplace add Mineru98/irasutoya-cli
/plugin install irasutoya-search@irasutoya-cli

Or non-interactively from your shell:

claude plugin marketplace add Mineru98/irasutoya-cli
claude plugin install irasutoya-search@irasutoya-cli

Then invoke the namespaced skill:

/irasutoya-search:irasutoya-search cat

Claude Plugin — Local directory (development)

Load the plugin straight from a local checkout, without a marketplace:

claude --plugin-dir .claude/plugins/irasutoya-search

Invoke it the same way (/irasutoya-search:irasutoya-search cat). After editing plugin files in a running session, run /reload-plugins or restart Claude Code.

Claude Project Skill (no plugin)

Start Claude Code from the repository root so it discovers .claude/skills/irasutoya-search:

claude

Then invoke the un-namespaced skill:

/irasutoya-search cat

Codex Skill

Use the project-local Codex skill from this repository:

python .codex/skills/irasutoya-search/scripts/irasutoya_search.py cat

In Codex, invoke it as $irasutoya-search or ask for an Irasutoya illustration search in natural language.

Verify the plugin loads

Validate the manifests and inspect the registered skill before publishing or after changes:

# Validate the marketplace and plugin manifests (use --strict in CI)
claude plugin validate .claude-plugin/marketplace.json --strict
claude plugin validate .claude/plugins/irasutoya-search --strict

# After installing, confirm the skill is registered
claude plugin list
claude plugin details irasutoya-search

claude plugin details irasutoya-search should report Skills (1) irasutoya-search.

Setup

The native Go CLI is the cross-platform distribution target for Windows, macOS, and Linux.

$ git clone https://github.com/Mineru98/irasutoya-cli.git
$ cd irasutoya-cli
$ go build ./cmd/irasutoya

The CI and release baseline is Go 1.26.4. The current go.mod remains compatible with the local migration environment's Go 1.24.3 toolchain until the local toolchain is upgraded.

Usage

$ irasutoya help
Commands:
  irasutoya random          # Gives you random irasutoya image
  irasutoya search {query}  # Gives you 3 irasutoya images by given query

The CLI accepts localized search terms for common ONE PIECE character demos, such as luffy, zoro, ルフィ, ゾロ, 路飞, 索隆, 루피, and 조로.

By default, the Go CLI prints page metadata and image URLs without opening external applications. To open image URLs with the OS default application, opt in explicitly:

$ irasutoya --open-images random
$ IRASUTOYA_OPEN_IMAGES=1 irasutoya search luffy

Development

$ go test ./...
$ go build ./cmd/irasutoya

Release builds use GoReleaser with CGO_ENABLED=0 for Windows, macOS, and Linux archives:

$ goreleaser check
$ goreleaser release --snapshot --clean

Contributing

Bug reports and changes for this fork are handled on GitHub at https://github.com/Mineru98/irasutoya-cli. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

This project is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the irasutoya-cli project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.

Author

Fork maintained by @Mineru98.

Original project by @unhappychoice.