Installation

WinGet · Windows

winget install --id RohitYadav.NcellCLI

Scoop · Windows

scoop bucket add ncell-cli https://github.com/rohityadav-sas/ncell-cli
scoop install ncell-cli

Homebrew · macOS / Linux

brew tap rohityadav-sas/ncell-cli https://github.com/rohityadav-sas/ncell-cli
brew install ncell-cli

Interactive mode

Open an interactive command prompt with live dropdown suggestions. No shell profile setup is needed.

ncell

Type ga to suggest game, then sp to suggest spin. Suggestions stay hidden at an empty prompt until you press Ctrl+Space.

Use the same commands as the normal CLI, without the ncell prefix. Required argument hints, plan sort directions and comma-separated fields are shown as you type. Category values come from the active account's catalog. Saved .ncell files are suggested for script commands.

Commands run against your saved account. Sending an SMS, subscribing to a plan and playing games have the same effects as their normal CLI commands. This is a live command prompt. It requires an interactive terminal; use ordinary commands and --json for automation.

Authentication

Sign in with an OTP. The code is visible as you type:

ncell login 98XXXXXXXX

Resume instead of resending OTP again

ncell login 98XXXXXXXX --verify

Use this after an interruption or mistyped OTP. It resumes the pending login for that number without generating another OTP.

Multiple accounts

Log in to save an account and switch to it. Use the commands below to manage saved accounts.

Add an account

Save another account without changing the active account.

ncell account add 98XXXXXXXX

List accounts

Show all saved accounts and which one is active.

ncell account list

Switch accounts

Switch to a saved account without requesting another OTP.

ncell account switch 98XXXXXXXX

Remove an account

Remove the specified saved account. If it is active, another saved account becomes active when available.

ncell account remove 98XXXXXXXX

Inspect or remove the saved session

Session status

Show the active account, login time and saved token expiry. This reads the saved session without checking token acceptance with Ncell.

ncell status

Log out

Remove only the active account. Another saved account becomes active if available.

ncell logout

Sessions and token refresh

Tokens and device identity are stored in a local session file (%LOCALAPPDATA%\ncell-cli\session.json on Windows, ~/Library/Application Support/ncell-cli/ on macOS, ~/.config/ncell-cli/ on Linux) readable only by you.

Automatic refresh

The saved refresh token is used automatically to refresh the access token when it expires.

Manual refresh

ncell refresh

Balance and profile

Check your balance

Show your current balance, data, voice and SMS allowances.

ncell balance

View your profile

Show the account number, name, SIM type, status, plan and payment mode.

ncell profile

Plans and categories

Browse plans

List plans in the default category 66.

ncell plans

List categories

Find the available category IDs.

ncell plans categories

View a specific category

List plans in category 61 (Voice). Use the category ID from the category list from ncell plans categories.

ncell plans --category 61

Search and sorting

Search within a category

Search for SMS plans in category 50.

ncell plans search "SMS" --category 50

Search and sort by price

Find matching plans, ordered by price from low to high.

ncell plans search "Super" --sort price

Search and sort by validity

Find matching plans, ordered by longest validity first, then lowest price.

ncell plans search "Combo" --sort validity:desc,price:asc

Sort by more than one field

Combine sort fields

Separate ordered sort fields with commas. This searches SMS plans and sorts by validity descending, then price ascending.

ncell plans search "SMS" --category 50 --sort validity:desc,price:asc

Repeat the sort option

Alternatively, supply one sort field per option.

ncell plans --sort validity:desc --sort price:asc

Use the default direction

Omit directions to sort both fields in ascending order.

ncell plans --sort validity,price

Supported fields are price and validity. Directions are asc and desc; default is asc.

Subscribe to a plan

Find a plan

List plans in the category and note the plan ID you want.

ncell plans --category 50

Subscribe

Use the plan ID and its category. Paid packs charge your Ncell account, so the command shows the name and price and asks for confirmation. Use --yes for scripts (required when input is piped) and --dry-run to preview without spending.

ncell plans subscribe 984 --category 50

The plan ID is a required positional argument. Use a category ID from the category list; --category defaults to 66.

Send Free SMS

ncell sms send-free 98XXXXXXXX "Hello"

Game rewards

Check in daily, claim task rewards, view your rankings, or play games.

Daily check-in

Claims today's check-in reward and displays your streak, weekly points and token balance.

ncell game check-in

Task status

Lists task IDs, progress, rewards and status.

ncell game status

Claim task rewards

Use task IDs from ncell game status.

ncell game claim-task 1,2,3

Claim every completed task.

ncell game claim-task all

Math

Unsupported questions ask you to enter an answer in the terminal.

ncell game math

Level  Question                      Answer  Result   Score
-----------------------------------------------------------

    1  9 + 4                             13  correct      5

    2  8 + 2                             10  correct     10

    3  avg(17, 11, 23)                   17  win        165

Math win | Score 165

Scratch card

Play a scratch card using your game tokens.

ncell game scratch

Game          Reward                  Tokens        Points
----------------------------------------------------------

Scratch 1     50 Points                  160         6,695

Spinner

Spin using your game tokens.

ncell game spin

Game          Reward                  Tokens        Points
----------------------------------------------------------

Spin 1        50 Points                  160         6,695

Rankings

Shows your weekly performance, last week's result, prizes and leaderboard.

ncell game ranks

Play multiple games

Multiple spins

Play three spins with a 1.5-second delay between games.

ncell game spin --count 3 --delay 1.5s

Multiple scratch cards

Play three scratch cards with a one-minute delay between games.

ncell game scratch --count 3 --delay 1m

Multiple math games

Play two math games with a 1.5-hour delay between games.

ncell game math --count 2 --delay 1.5h

• --count is number of games (default 1).
• --delay is the amount of waiting time between each game (defaults is 0)

Use remaining tokens

Use --count all to use all tokens to play the game until you run out of tokens.

ncell game spin --count all --delay 1.5s

Scripts

Create a reusable script for running multiple commands at once.

Create a script

Use a name ending in .ncell.

ncell script create daily.ncell

List scripts

List scripts saved in the CLI, sorted by name.

ncell script list

Edit a script

Opens a saved script in your default text editor.

ncell script edit daily.ncell

Delete a script

Delete a script using its name. This does not affect files in the current folder.

ncell script delete daily.ncell

Run a script

Edit and save the file, then run it by name. The CLI checks saved scripts first, then the current folder.

ncell script run daily.ncell

File format

Write command per line. The ncell prefix is optional. Blank lines and lines starting with # are ignored. Use single or double quotes around arguments containing spaces.

sms send-free 98XXXXXXXX "Hello from my script"

Script example

# Daily rewards
ncell game check-in
ncell game claim-task 1,2,3,4,5,6,7,8

# Spinner reward
ncell game spin --count 5
ncell game claim-task 22

# Scratch card reward
ncell game scratch --count 4
ncell game claim-task 23

# Math reward
ncell game math --count 1
ncell game claim-task 26

# Game Warrior reward
ncell game claim-task 18

# Math Genius reward
ncell game math --count 4
ncell game claim-task 24

# Spend remaining tokens
ncell game spin --count all

# Final checks
ncell game status
ncell game ranks

Command reference