Meno CLI

Command-line interface for Meno time tracking. Track your time directly from your terminal.

Installation

npm install -g @usemeno/meno-cli

Or install locally:

cd packages/meno-cli
npm install
npm run build
npm link

Setup

1. Generate an API key in your Meno web app (Settings → API Keys)
2. Authenticate the CLI:

meno login

Paste your API key when prompted.

Commands

meno select

Select a project first, then select a task to work on. The selected task will be used for meno start.

meno select

Use arrow keys to select a project and task, or choose "[Clear Selection]" to unset both.

meno start [task-id]

Start a timer on the selected task, or specify a task ID:

# Start on selected project
meno start

# Start on specific task
meno start clf123abc

Only one timer can run at a time.

meno create [title]

Create a task from CLI.

• If a project is selected, task is created in that project.
• If no project is selected, CLI prompts you to choose a project.
• Created task is auto-selected for meno start.

# Quick create
meno create "Implement auth middleware"

# With extra fields
meno create "Fix dashboard bug" --description "Handle empty state" --estimate 1.5 --priority High

meno stop

Stop the running timer and log the entry:

meno stop

You'll be prompted for a description.
Add --discard to cancel without logging.

meno log <description>

Manually log time without using a timer:

meno log "Fixed authentication bug" --duration 1.5h --project clf123abc

Duration formats:

• 45m = 45 minutes
• 1.5h = 1.5 hours
• 90 = 90 minutes (default unit)

meno status

Show your current status:

• CLI version
• Update availability (checked once per day)
• Selected project
• Running timer (if any)
• Unbilled revenue and hours

meno status

Workflow Example

# Morning: Select your project and task
meno select
> Website Redesign (Acme Corp)
> Build hero section → Website Redesign [InProgress]

# Start working
meno start

# ... work for 2 hours ...

# Stop and log
meno stop
> What were you working on? Built homepage hero section
> Log this entry? Yes
✓ Logged 2.00 hours to Website Redesign

# Quick status check
meno status
CLI version: v0.1.3
⬆ Update available: v0.1.4
Run: npm update -g @usemeno/meno-cli
💰 Unbilled Revenue: $1,234.56
⏱️  Total Hours: 45.5 hours across 12 entries

Configuration

Config is stored at ~/.config/meno-cli/config.json (cross-platform).

Contains:

• apiKey - Your Meno API key
• selectedProject - Currently selected project
• selectedTask - Currently selected task
• activeTimer - Running timer state (persists across restarts)

Troubleshooting

"Not logged in" error: Run meno login to authenticate.

"No project selected" error: Run meno select to choose a project, or pass --project <id> to commands.

Connection errors: Check your internet connection. CLI uses https://menohq.app.

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Link for local testing
npm link

License

MIT