Getting Started

Install abacus-cli and log your first time entry in minutes.

Prerequisites

  • Node.js 18+
  • Access to an Abacus web portal (provided by your company)

Installation

Terminal
npm install -g abacus-cli

Chromium is downloaded automatically on install for browser automation.

Configuration

Set your Abacus instance URL via environment variable:

export ABACUS_URL="https://your-abacus-instance.example.com/portal/myabacus"

Or use the config command:

abacus config set url https://your-abacus-instance.example.com/portal/myabacus
Variable Default Description
ABACUS_URL https://abacus.example.com/portal/myabacus Base URL of your Abacus portal
ABACUS_CONFIG_DIR ~/.abacus-cli Directory for session state

First Login

Open a real browser window for manual login. Session cookies are persisted locally so subsequent commands run headlessly.

abacus login

Your First Time Entry

abacus time log --project 12345 --hours 8 --service-type 100 --text "Development"

If a matching entry (same date + project) already exists, you'll be prompted to update it or create a new one.

Check Your Status

Get a compact weekly status:

abacus summary
Week 06 · 32.5 / 40h · 7.5h remaining · Wed, Thu missing
Overtime: +12.5h (1.6d) · Vacation: 15.0d left
(updated 2h ago)