@mtsku/anilist-cli
v0.2.5
Published
Reliable AniList CLI for search, discovery, social, and list management via direct GraphQL API.
Readme
@mtsku/anilist-cli
AniList CLI for search, discovery, airing schedules, social views, and list updates via GraphQL.
Install
Global install:
npm install -g @mtsku/anilist-cli
anilistcli --helpRepository/local runner:
npm install
npm run build
./scripts/anilistcli --helpUse anilistcli on PATH when available. Use ./scripts/anilistcli only when running from this repository.
Authentication
Token precedence:
--token <token>ANILIST_TOKENorANILIST_ACCESS_TOKEN~/.config/anilist-cli/config.json
anilistcli auth set-token "<token>"
anilistcli auth where
anilistcli whoamiCommand Groups
anilistcli search <anime|manga|character|staff|user> "<query>" -n 5
anilistcli discover seasonal --season WINTER --year 2026 -n 20
anilistcli discover upcoming -n 15
anilistcli airing upcoming --hours 48 -n 25
anilistcli airing next "<title>"
anilistcli airing mine --hours 72 --limit 50
anilistcli mine summary --hours 72 -n 10
anilistcli media recs "<title>" -n 10
anilistcli media relations "<title-or-url>"
anilistcli profile [username]
anilistcli user <username>
anilistcli friends [username] -n 50
anilistcli followers [username] -n 50
anilistcli following [username] -n 50
anilistcli list view --type anime --status-in "CURRENT,PLANNING"
anilistcli planning add "<title>"
anilistcli status set "<title>" CURRENT
anilistcli progress set "<title>" 12planning also supports alias watchlater.
JSON and Dry Run
anilistcli --json discover upcoming -n 5
anilistcli --json airing mine --hours 48 -n 20
anilistcli --json mine summary --hours 48 -n 8
anilistcli --dry-run status set "<title>" PAUSED --json