From instacart-for-agents
Operate the Instacart for Agents Codex plugin for phone OTP login, session verification, store discovery, cart analysis, and safe grocery planning.
How this skill is triggered — by the user, by Claude, or both
Slash command
/instacart-for-agents:instacart-for-agentsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this skill when the user asks Codex to log into Instacart, verify an Instacart session, compare grocery stores, plan a cart, inspect a cart, or safely mutate a cart through the local Instacart API.
Use this skill when the user asks Codex to log into Instacart, verify an Instacart session, compare grocery stores, plan a cart, inspect a cart, or safely mutate a cart through the local Instacart API.
.codex-plugin/plugin.json..agents/plugins/marketplace.json.PORT=6082 \
START_URL='https://www.instacart.ca/store/?categoryFilter=homeTabForYou' \
USER_DATA_DIR='/home/hermes/shared-browser/profile-instacart' \
HEADLESS=true \
NODE_PATH=/home/hermes/shared-browser/node_modules:/home/hermes/.hermes/hermes-agent/node_modules \
node /home/hermes/shared-browser/server.js
cd /home/hermes/commerce-api
INSTACART_CONTROLLER_URL=http://127.0.0.1:6082 npm run dev
curl -fsS http://127.0.0.1:7077/health
curl -fsS http://127.0.0.1:7077/instacart/login/status
Most new users start here. Prefer phone-number OTP; do not ask for passwords.
curl -s http://127.0.0.1:7077/instacart/login/start \
-H 'content-type: application/json' \
-d '{"phoneNumber":"+15555550123"}'
# User receives the SMS OTP and gives it to the agent.
curl -s http://127.0.0.1:7077/instacart/login/otp \
-H 'content-type: application/json' \
-d '{"otpCode":"123456"}'
curl -s http://127.0.0.1:7077/instacart/login/status
After OTP submission, verify loggedIn: true before planning or mutating a cart. If Instacart shows extra account-security prompts, stop and ask the user to complete them manually.
If /instacart/login/status returns loggedIn: true, continue directly:
curl -s http://127.0.0.1:7077/instacart/analysis
curl -s http://127.0.0.1:7077/instacart/cart-plan \
-H 'content-type: application/json' \
-d '{"maxSubtotal":250,"requireHalal":true,"preferPromotions":true,"focus":["budget","protein"],"people":2,"days":14}'
Before building a cart, compare all visible Instacart.ca grocery stores for the active address. Include Food Basics, Costco, Costco Business Centre, Walmart, No Frills, Adonis, FreshCo, Metro, Iqbal Foods, Real Canadian Superstore, Wholesale Club, and any additional visible grocery store.
If you need more detail, read:
SKILLS/instacart-phone-otp-login/SKILL.mdSKILLS/instacart-grocery-planning/SKILL.mdSKILLS/instacart-store-discovery/SKILL.mdSKILLS/instacart-api/SKILL.mdCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub waleeeeed88/instacart-for-agents --plugin instacart-for-agents