Skip to content
rishibhaskar777Public

About

Turns any goal into one clear plan: which AI tools to use, in what order, with starter prompts. English & Hindi.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

WhichAI

A neutral guide that tells people which AI tools to use for a given goal, and how to use them. It returns one clear plan per goal (AI, plugins, libraries, database, deployment, cost) at three levels: Simple, Polished and Advanced.

It does not do the task for the user. It recommends, explains the trade-offs, and lets the user choose.

Status

Early development. See docs/ROADMAP.md for the phases.

Phase Scope State
1 Project setup, home page, security baseline Done
2 Understanding step and plan view Done
3 Tool data in JSON, rules engine In progress
4 Sign-in, saved plans and feedback Done
5a Tool catalogue, Get it links, library Done
5b News from official feeds, What Changed Done
5c Weekly discovery of new tools, reviewed Done
6 Pricing, checkout preview, legal pages Done

The project follows a zero-cost rule: no paid APIs, no AI APIs, no hosted databases, no trackers.

Tech

TypeScript throughout. Next.js (App Router), React, CSS Modules with CSS custom properties for design tokens, Vitest for tests. Details and reasons are in docs/decisions/0001-tech-stack.md.

Getting started

Requirements: Node.js 24 (see .nvmrc) and npm. The first build downloads the font files once, so it needs network access.

git clone https://github.com/rishibhaskar777/whichai.git
cd whichai
npm ci
cp .env.example .env.local
npm run dev

The site runs at http://localhost:3000. Sign-in is optional and needs free Google and GitHub OAuth credentials; see docs/AUTH-SETUP.md.

Scripts

Command What it does
npm run dev Start the development server
npm run build Production build
npm run start Serve the production build
npm run lint Run ESLint
npm run typecheck Run the TypeScript compiler without emitting files
npm test Run unit tests
npm run data:report Print how much of the tool catalogue is verified
npm run data:version Write the catalogue version after a data change
npm run links:check Check every catalogue address (run by hand)
npm run news:check Fetch every news source and report broken ones
npm run discover:dry-run Show what the weekly tool discovery would find
npm run discover:import -- <n> Add an approved candidate to the catalogue

Project layout

Next.js App Router with a src/ directory: app/ for routes, components/ for UI, lib/ for validation and security helpers, styles/ for design tokens, data/catalogue/ for the tool catalogue (JSON), lib/engine/ for the rules engine, lib/plan/ for the goal interpreter, lib/news/ and data/news/ for the news feeds, lib/discovery/ and data/discovery/ for tool discovery, lib/pricing/ and data/pricing/ for plans and prices. src/proxy.ts sets the CSP nonce and security headers on every request. Details are in docs/ARCHITECTURE.md.

What works now

  • Home page with a goal input, suggestion chips and an AI news panel.
  • Describe a goal and a local, rule-based interpreter (no AI service) shows what it understood as chips you can remove or add. It tolerates typos, understands synonyms, and turns a task such as "make a logo" into tool picks. Only text it recognises nothing in gets an honest "no plan yet" message.
  • Confirm to see a plan at Simple, Polished and Advanced levels. It lists the right mix of AI tools, models, libraries and services for the goal: a toolkit at a glance, a card per job with the kind of tool, which model class to use for which step, compatibility, other options, a workflow with copyable prompts and a starter brief. Over forty goals are covered, and a goal that matches no template gets a plan built from the parts the sentence names. Add or remove a part on the plan or on the understanding card.
  • A "Make this more accurate" card feeds your monthly budget and the tools you already use back into the engine. At ₹0 only tools with a free option, or one not yet confirmed, remain. A tool you already use is marked Keep when it scores close to the best.
  • Tool Library at /tools: about 300 tools, models, extensions and command-line tools, with search, filters (category, job, kind, platform, free option, verified), sort and shareable URLs. Each tool has a page at /tools/<id> and a Get it block with official download links, shown for your platform first. Pick up to three tools and open Compare at /compare. See 0011.
  • All tool data is unverified. The catalogue (about 300 tools) holds stable facts only. Prices appear only where an official pricing page was read (with its date); otherwise a card links to the pricing page. Fit scores are editorial estimates, not test results, and the About page says so. Records stay unverified until a person checks them (docs/VERIFYING-DATA.md). Nothing you type is sent anywhere. The goal text stays in the browser history entry for the visit and out of the address, so a reload starts with an empty search.
  • Saved plans (Projects). Save stores only the plan request (goal type, chips, level, budget, tools you use) in your browser, in IndexedDB with a localStorage fallback. Opening one rebuilds the plan from current data, and a badge shows when tools were updated since you saved. Rename, duplicate, delete with Undo, search and sort. The sidebar shows your five most recent. Nothing is sent to a server (0009).
  • Search history (Searches), grouped by Today, Yesterday, Previous 7 days and Older, with re-run, delete and clear. It can be switched off.
  • Share links, export and import, PDF. Copy share link puts the plan request after the # so it never reaches the server. Export all local data to one JSON file, import it with validation (max 1 MB, merge or replace). Download PDF opens the print dialog with a clean print stylesheet.
  • Settings at /settings: language (English, हिन्दी), theme, reduce motion, default level and budget, currency display, history, data export, import and clear, account and about. Language and theme are also kept in cookies so the server renders them without a flash.
  • Hindi. All interface text is translated with a small typed dictionary (0010). The Hindi text still needs native review, and tool details stay in English.
  • Help, About and a custom 404 page; keyboard shortcuts (/, Ctrl or Cmd+Shift+O, ?); Send feedback opens a GitHub issue form.
  • Collapsible sidebar, mobile drawer, light, dark and system themes (the explicit choice is stored in a cookie).
  • Sign in with Google or GitHub from the sidebar, in a glass popup (or at /sign-in without JavaScript). The session is an encrypted cookie that holds only your provider, provider id and name; there is no database, and your plans still stay in this browser. The popup lists Google, GitHub, Microsoft, Apple, email and phone; Google and GitHub work once configured and the rest say they are coming in an upcoming update. See 0008.
  • A plain-language privacy page at /privacy that says what stays on your device and how to delete it.
  • AI news from official sources. The server reads about 30 public RSS and Atom feeds (company blogs, changelogs, GitHub releases of official repositories), at most every 30 minutes, and keeps the last good result if a feed fails. The panel shows the six newest headlines with source, age, tag and a New badge. What Changed at /what-changed lists everything from the last 60 days with search, tag and source filters and pages, all in the URL, and each tool page shows its recent news. A headline gets an "Affects your plans" badge when a plan saved on your device uses that tool; that check never leaves your device. Headlines stay in their original language and link to the source. See 0012 and docs/NEWS-SOURCES.md.
  • Tool discovery. A weekly GitHub Actions job looks for new AI tools on GitHub, Hugging Face, Hacker News and our own news feeds, and follows what it finds in one watchlist issue. A candidate gets an issue of its own, with the evidence and the closest listed tools, only when it passes every admission rule. Nothing enters the catalogue without a person approving it: the approved label posts a draft record, and npm run discover:import adds it locally for you to verify and commit. See docs/TOOL-DISCOVERY.md and 0013.
  • Plans and pricing. /pricing shows Free, Plus, Pro, Ultra and Institution in rupees, with a monthly and yearly switch kept in the URL, a comparison table and a FAQ. Everyone is on Free and paid plans are not open: /checkout is a preview whose Pay button only opens a dialog saying payments are coming in an upcoming update. No payment details are asked for and nothing is sent. Settings has a Subscription section, the account row shows a quiet "Free plan" line, and draft Terms, Refund policy and Contact pages exist (linked from Settings, under About & legal, and from the bottom of the pricing and checkout pages). Plans and prices are edited in src/data/pricing/plans.json; see docs/PRICING.md and 0014.

Security

Please report vulnerabilities privately. See SECURITY.md.

Contributing

See CONTRIBUTING.md.

License

All rights reserved. A license will be added if the project is opened up.

About

Turns any goal into one clear plan: which AI tools to use, in what order, with starter prompts. English & Hindi.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages