explaingit

realzachi/shopi-cli

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A command line tool that lets you read and write Shopify store data directly through its Admin API.

Mindmap

mindmap
  root((shopi))
    What it does
      Reads Shopify store data
      Writes with confirm safety
      Runs raw GraphQL queries
    Tech stack
      TypeScript
      Bun
      Shopify Admin API
    Use cases
      List products or orders
      Create a product safely
      Automate store tasks in CI
    Audience
      Store owners
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

List and filter Shopify products or orders from the command line.

USE CASE 2

Create or update Shopify data safely with an explicit confirm step.

USE CASE 3

Run raw Shopify GraphQL queries for full control over what is requested.

USE CASE 4

Wire Shopify actions into automated scripts or CI jobs using JSON output.

What is it built with?

TypeScriptBunGraphQLShopify Admin API

How does it compare?

realzachi/shopi-cliagbara286/saint-cmsanuj-kumary/your-github-contributions
Stars222
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-07
MaintenanceMaintained
Setup difficultyeasyeasymoderate
Complexity2/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires creating a Shopify developer app and granting it the needed API access scopes.

Use, modify, and share freely, including for commercial projects, as long as you keep the copyright notice.

In plain English

Shopi is a command line tool for talking to a Shopify store through its Admin API, the interface Shopify provides for reading and changing data like products, orders, and customers. It is built for store owners, developers, automated scripts, and AI coding assistants alike, and its output is designed to be read by both humans and programs. Rather than wrapping only a fixed set of common actions, shopi reads the live structure of your own store's API and lets you call almost anything Shopify exposes, so it stays useful even as your store's setup changes. There are three main ways to use it. You can read data with commands that map directly to Shopify's query options, such as listing products or orders with filters. You can write data with matching commands for actions like creating a product, though every write requires you to explicitly add a confirm flag before anything actually changes, which helps prevent accidental edits. You can also send a raw, exact query written in Shopify's own query language if you want full control over exactly what is requested. To connect it to a store, you create a small app in Shopify's own developer dashboard, choose only the specific permissions your work needs, such as permission to read products or write orders, and give shopi the resulting login details through a settings file or an environment file. The tool then exchanges those details for a short lived access token each time it runs, so nothing especially sensitive sits on disk long term. It respects whatever permissions the connected app was granted and simply refuses to run a request the app was not allowed to make. The tool prints results as readable tables when used directly in a terminal, but switches automatically to plain JSON when its output is being piped into another program or run inside a script, which makes it fit naturally into automated workflows. It runs on the Bun JavaScript runtime, is written in TypeScript, and is released under the MIT license. It is an independent project and is not made or endorsed by Shopify.

Copy-paste prompts

Prompt 1
Help me install shopi and connect it to my Shopify store with the right access scopes.
Prompt 2
Show me how to safely dry-run and then confirm a productCreate write with shopi.
Prompt 3
Write a shopi command to list all paid orders from the last week.
Prompt 4
Explain how shopi handles Shopify access tokens so I understand what's stored on disk.

Frequently asked questions

What is shopi-cli?

A command line tool that lets you read and write Shopify store data directly through its Admin API.

What language is shopi-cli written in?

Mainly TypeScript. The stack also includes TypeScript, Bun, GraphQL.

What license does shopi-cli use?

Use, modify, and share freely, including for commercial projects, as long as you keep the copyright notice.

How hard is shopi-cli to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is shopi-cli for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.