Kramm • Terminal Control Engine • v1.0.0

Control Kramm from your terminal
— the beginner's guide

The Kramm CLI lets 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.

Requires: Node.js 18+ · repo cloned · 5 minutes Works on Windows · macOS · Linux
Open as web page (kramm.app/cli-guide) → Start guide ↓
What you'll do
  1. Open a terminal in the Kramm folder
  2. Activate the kramm command
  3. Log in (one-time setup)
  4. Enter interactive control mode
  5. Add your first task with plain English
  6. See today's tasks & finish one
  7. Control boards & plugins
  8. Habits, budget, focus & AI
  9. One-shot commands (no interactive mode)
  10. Cheat sheet & fixing problems

1 Open a terminal in the Kramm folder

Everything runs from the project root — the folder containing package.json and the cli/ folder.

  1. Open PowerShell (Windows) or Terminal (macOS/Linux).
  2. Move into the project, e.g. cd C:\Users\admin\Desktop\Kram.
  3. Check Node is installed (you need version 18 or newer):
powershell
PS> node --version
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.

powershell
PS> npm link

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.

  1. Open Kramm in your browser → Settings → Access Tokens → New token. Copy the token (it starts with kpat_… — it's shown only once).
  2. Back in the terminal, save it:
powershell
PS> kramm login kpat_YOUR_TOKEN_HERE
✔ Access token saved. You are now authenticated.
  1. Confirm who you are:
powershell
PS> kramm "/auth whoami"
User ID: 64de22df-…
API Target: https://fastdo-gamma.vercel.app/api/mcp
Access Token: kpat_abc… (Configured)
🔑 Your token lives in ~/.kramm/config.json on your machine only. Never paste it into chats or screenshots. kramm /logout wipes it.

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:

powershell
PS> kramm ← just this, or…
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.

kramm ❯ interactive
kramm ❯ /add task Harsh wants a meet at 11
✔ 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]

6 See today's tasks — then finish one

List, complete, edit or delete. IDs come from the list.

kramm ❯ interactive
kramm ❯ /show today tasks
Tasks for today · 0 completed · 1 pending
[○ TODO] #27 [---] 11:00 Kramm Mobile app apk testing…

kramm ❯ /complete 27
✔ Task #27 marked as completed!

kramm ❯ /update 27 New title --date 2026-09-13 --priority A1
✔ Task #27 updated.

7 Control boards, plugins & connections

Boards are workspace pages (Calendar, Habits, Budget…). Plugins are integrations (Notion, Drive…). Toggle them like light switches.

kramm ❯ interactive
kramm ❯ /boards ← list all 12 boards + ON/OFF
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

8 Habits, 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.

powershell
PS> kramm "/add task Harsh wants a meet at 11"
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"
⚠️ Quoting rule (PowerShell): wrap slash commands in double quotes — kramm "/show today tasks" — so spaces stay together.

10 Cheat sheet & fixing problems

The 80/20 of the CLI on one screen.

CommandWhat it does
kramm / kramm controlOpen interactive mode
/add task … · /show today tasks · /tasks allCreate & view tasks
/complete · /uncomplete · /update · /deleteManage by ID
/boards · /board enable|disable|toggleWorkspace pages
/plugins · /plugin enable|disable|configIntegrations
/habits · /log habit · /budget · /goals · /pomodoroLife tracking
/ai ask · /breakdown · /self-improve · /progressIntelligence
/status · /health · /login · /logout · /config · /help · /exitSystem
SymptomFix
kramm not recognizedRe-run npm link in the project root, then restart the terminal. Or use node bin/kramm.js ….
“Unauthorized” / empty datakramm 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-sessionType /help — the full reference prints inside the REPL.
Made for Kramm · CLI v1.0.0 · Full reference: cli/README.md · Commands: kramm --help · Stay productive. kramm ❯