@usemeno/meno-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 usemeno
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# Meno CLI
+
+Command-line interface for Meno time tracking. Track your time directly from your terminal.
+
+## Installation
+
+```bash
+npm install -g @usemeno/cli
+```
+
+Or install locally:
+
+```bash
+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:
+
+```bash
+meno login
+```
+
+Paste your API key when prompted.
+
+## Commands
+
+### `meno select`
+
+Select a project to work on. The selected project will be used for `meno start`.
+
+```bash
+meno select
+```
+
+Use arrow keys to select a project, or choose "[Clear Selection]" to unset.
+
+### `meno start [project-id]`
+
+Start a timer on the selected project, or specify a project ID:
+
+```bash
+# Start on selected project
+meno start
+
+# Start on specific project
+meno start clf123abc
+```
+
+Only one timer can run at a time.
+
+### `meno stop`
+
+Stop the running timer and log the entry:
+
+```bash
+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:
+
+```bash
+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:
+- Selected project
+- Running timer (if any)
+- Unbilled revenue and hours
+
+```bash
+meno status
+```
+
+## Workflow Example
+
+```bash
+# Morning: Select your project
+meno select
+> Website Redesign (Acme Corp) •  $150/hr
+
+# 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
+💰 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
+- `baseUrl` - API endpoint (default: http://localhost:3000)
+- `selectedProject` - Currently selected project
+- `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 `baseUrl` in config. For production, use `https://app.meno.com`.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Link for local testing
+npm link
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node