gitwtfhub

wtf is w-bonkers?

somchandra17/w-bonkers — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TL;DR

Turns Claude Code or Codex into a rule-based portfolio assistant for Indian NSE stocks, tracking your plan as data and sending orders to Todoist for you to place manually.

Mindmap

mindmap
  root((repo))
    What it does
      Portfolio rules engine
      Todoist order tasks
      Local plan archive
    Tech stack
      Python
      Claude Code
      Codex
      Groww MCP
    Use cases
      Track NSE stock plan
      Get buy and stop-loss tasks
      Review plan history offline
    Audience
      Individual investors
      Vibe coders

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

Why would anyone build with this?

REASON 1

Keep a disciplined NSE stock plan as a single data file instead of re-explaining it to an AI each time.

REASON 2

Get buy zone, stop-loss, and target prices delivered as Todoist tasks you place yourself.

REASON 3

Run a scheduled refresh that only changes your plan when a defined rule actually fires.

REASON 4

Keep a fully local, offline archive of prices, news, and past trading decisions.

What's in the stack?

PythonClaude CodeCodexGroww MCPTodoist

How it stacks up

somchandra17/w-bonkers0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultymoderateeasyhard
Complexity3/52/55/5
Audiencevibe codergeneralresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires connecting a Groww account for live prices and a Todoist account for the feedback loop, a one-time OAuth login is needed for each.

Use, modify, and redistribute freely, including commercially, as long as you keep the copyright notice.

Wtf does this do

w-bonkers turns Claude Code or Codex into a disciplined assistant for managing a stock portfolio on the Indian NSE market. The idea behind it is that most investment plans do not fail because of bad stock picks, they fail because of drift: forgetting what you decided last week, redrawing your stop losses in your head, or losing track of your own rules. This project tries to fix that by keeping your entire plan as data in a single file called state.json, rather than as a memory the AI has to reconstruct every time you talk to it. A one time installer interviews you about your goals, how much money you are investing, your risk appetite, and your existing holdings, sometimes even reading a salary PDF for tax context, and writes all of that into your plan file. After that, a refresh command you run on a schedule reads any feedback you left, pulls current market prices, applies a fixed set of rules, and only changes the plan when a rule actually triggers. Most days, nothing changes. Your buy and sell orders show up as tasks in Todoist, each one listing the buy zone, stop loss, and target price. You place the actual trades yourself in your broker's app, then check off the task and can leave a comment like "bought at 332", which the next run reads before doing anything else. The agent itself never places trades, since the market data connection it uses is read only for trading. Everything the system fetches, including prices, news, and past decisions, is saved locally, so the whole plan and its history survive even without the AI or an internet connection. To use it, you need Claude Code or the Codex CLI, a Groww connection for live prices and holdings, and a Todoist connection for the feedback loop, plus Python with a few packages for rendering and fallback prices. Setup is a git clone followed by telling your AI agent to read and run an installer prompt, which handles authorization, the interview, and scheduling, in about fifteen minutes. This is explicitly framed as an education project, not investment advice, and the author notes it is very new, having only been running on real money since July 2026. It is released under the MIT license.

Yoink these prompts

Prompt 1
Read prompt.md and execute it to set up my w-bonkers portfolio plan.
Prompt 2
Explain how state.json and render_plan.py keep my plan drift-proof between runs.
Prompt 3
Walk me through connecting the Groww MCP and Todoist MCP for w-bonkers.
Prompt 4
Show me what happens in a daily /w-bonkers refresh when a stock breaks its stop-loss rule.

Frequently asked questions

wtf is w-bonkers?

Turns Claude Code or Codex into a rule-based portfolio assistant for Indian NSE stocks, tracking your plan as data and sending orders to Todoist for you to place manually.

What language is w-bonkers written in?

Mainly Python. The stack also includes Python, Claude Code, Codex.

What license does w-bonkers use?

Use, modify, and redistribute freely, including commercially, as long as you keep the copyright notice.

How hard is w-bonkers to set up?

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

Who is w-bonkers for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.