Kramm / CLI Guide
Control Kramm from your terminal
— the beginner's guide
The Kramm CLIlets you add tasks, view your day, toggle boards & plugins, track habits and budget — all by typing commands, Claude Code-style. No clicking. This guide takes you from zero to power user in 10 steps.
- Open a terminal in the Kramm folder
- Activate the kramm command
- Log in (one-time setup)
- Enter interactive control mode
- Add your first task with plain English
- See today's tasks & finish one
- Control boards & plugins
- Habits, budget, focus & AI
- One-shot commands (no interactive mode)
- Cheat sheet & fixing problems
Offline? Open the standalone page · Full API surface: cli/README.md
1 Open a terminal in the Kramm folder
Everything runs from the project root — the folder containing package.json and the cli/ folder.
- Open PowerShell (Windows) or Terminal (macOS/Linux).
- Move into the project, e.g. cd C:\Users\admin\Desktop\Kram.
- Check Node is installed (you need version 18 or newer):
v22.14.0 ← any v18+ is fine
2 Activate the kramm command
This links the CLI so you can type kramm from anywhere. You do it once.
PS> kramm --version
kramm v1.0.0 ✔ you're in business
No admin rights? Skip linking — node bin/kramm.js and npm run kramm -- work identically.
3 Log in — one-time setup
The CLI talks to your Kramm account with a Personal Access Token. Create it in the web app, then paste it once.
- Open Kramm in your browser → Settings → Access Tokens → New token. Copy the token (it starts with kpat_…— it's shown only once).
- Back in the terminal, save it:
✔ Access token saved. You are now authenticated.
- Confirm who you are:
User ID: 64de22df-…
API Target: https://fastdo-gamma.vercel.app/api/mcp
Access Token: kpat_abc… (Configured)
4 Enter interactive control mode
This is the Claude Code-style REPL: a live prompt with Tab autocompletion and slash commands. Any of these open it:
PS> kramm control ← same thing, explicit
kramm ❯ ← the live prompt. Type /help and hit Enter.
Inside, press Tab to autocomplete commands and Ctrl+C (or /exit) to leave.
5 Add your first task — just type English
The CLI understands dates, times, priorities and repetition inside normal sentences. Today's date is assumed.
✔ Task Created ID #27 · Date today · Time 11:00
kramm ❯ /add task Doctor appointment tomorrow at 4:30pm #urgent
✔ Task Created Date tomorrow · Time 16:30 · Priority [A1]
- Magic words it understands: today, tomorrow, weekdays (every monday), times (at 11, 4:30pm), #urgent / priority A1, daily / monthly.
- Lazy mode: skip the command entirely — bare text like Buy milk at 6pm is treated as a new task automatically.
6See today's tasks — then finish one
List, complete, edit or delete. IDs come from the list.
Tasks for today · 0 completed · 1 pending
[○ TODO] #27 [---] 11:00 Kramm Mobile app…
kramm ❯ /complete 27
✔ Task #27 marked as completed!
kramm ❯ /update 27 New title --date 2026-09-13 --priority A1
✔ Task #27 updated.
- /tasks all — everything, all dates.
- /uncomplete 27 — reopen. /delete 27 — remove forever.
- /breakdown Launch marketing campaign — AI splits big tasks into timed steps.
7Control boards, plugins & connections
Boards are workspace pages (Calendar, Habits, Budget…). Plugins are integrations (Notion, Drive…). Toggle them like light switches.
kramm ❯ /board enable weekly_view
kramm ❯ /board disable pomodoro
kramm ❯ /plugins ← Notion, Drive, Gmail, GitHub…
kramm ❯ /plugin enable notion
kramm ❯ /plugin config notion ← stored settings
kramm ❯ /integrations ← live OAuth status (Notion/Drive)
kramm ❯ /integrations capabilities
8Habits, money, focus & AI
One prompt rules all of Kramm. A few favorites:
| Want to… | Type this |
|---|---|
| Track a habit | /add habit Morning run → /habits → /log habit 1 |
| Log spending | /add expense 25 food Team lunch → /budget |
| Log income / goals | /add income 3000 salary · /add goal "MacBook" 2000 → /goals |
| Focus session | /pomodoro 25 Finish report (live countdown + bell) |
| Ask AI | /ai ask How should I structure deep work? |
| Health check | /status · /progress · /health · /self-improve |
9 Skip the REPL — one-shot commands
Every slash command also works straight from the shell. Handy for scripts and quick adds.
PS> kramm "Harsh wants a meet at 11" ← same, bare text
PS> kramm "/show today tasks"
PS> kramm "/complete 27"
PS> kramm "/board enable weekly_view"
10Cheat sheet & fixing problems
The 80/20 of the CLI on one screen. Copy-friendly.
| Command | What it does |
|---|---|
| kramm / kramm control | Open interactive mode |
| /add task … · /show today tasks · /tasks all | Create & view tasks |
| /complete · /uncomplete · /update · /delete | Manage by ID |
| /boards · /board enable|disable|toggle | Workspace pages |
| /plugins · /plugin enable|disable|config | Integrations |
| /habits · /log habit · /budget · /goals · /pomodoro | Life tracking |
| /ai ask · /breakdown · /self-improve · /progress | Intelligence |
| /status · /health · /login · /logout · /config · /help · /exit | System |
| Symptom | Fix |
|---|---|
| kramm not recognized | Re-run npm link in the project root, then restart the terminal. Or use node bin/kramm.js …. |
| "Unauthorized" / empty data | kramm login kpat_… again, then kramm "/auth whoami" — token must show Configured. |
| Shows "Direct Database" instead of "API Online" | Check internet / deployment URL: kramm "/health" and kramm "/config get". |
| Forgot syntax mid-session | Type /help — the full reference prints inside the REPL. |
Also available as standalone HTML for offline use.