toggl
Track time with Toggl via the toggl CLI. Use when the user wants to start/stop time tracking, check current timer, view today's or weekly reports, list recent entries, or manage time entries. Triggers on "toggl", "time tracking", "timer", "track time", "what am I working on", "log time", "timesheet".
What this skill does
# Toggl Time Tracking
Use the `toggl` CLI (@beauraines/toggl-cli) for Toggl Track integration.
## Prerequisites
Install the CLI:
```bash
npm install -g @beauraines/toggl-cli
```
Configure authentication (create `~/.toggl-cli.json`):
```json
{
"api_token": "YOUR_TOGGL_API_TOKEN",
"default_workspace_id": "YOUR_WORKSPACE_ID",
"timezone": "Your/Timezone"
}
```
Get your API token from: https://track.toggl.com/profile
Get your workspace ID from your Toggl URL: `https://track.toggl.com/{workspace_id}/...`
Set permissions: `chmod 600 ~/.toggl-cli.json`
## Commands
### Status
```bash
toggl now # Show running timer
toggl me # Show user info
```
### Start/Stop
```bash
toggl start # Start timer (interactive)
toggl start -d "Task name" # Start with description
toggl start -d "Task" -p "Project" # With project
toggl stop # Stop current timer
```
### Continue Previous
```bash
toggl continue # Restart most recent entry
toggl continue "keyword" # Restart entry matching keyword
```
### Reports
```bash
toggl today # Today's time by project
toggl week # Weekly summary by day
```
### List Entries
```bash
toggl ls # Last 14 days
toggl ls -d 7 # Last 7 days
toggl ls --today # Today only
toggl ls "search term" # Search entries
```
### Add Completed Entry
```bash
toggl add "9:00AM" "10:30AM" "Meeting notes"
```
### Edit Current
```bash
toggl edit -s "10:00AM" # Change start time
toggl edit -d "New desc" # Change description
toggl edit -p "Project" # Change project
```
### Delete
```bash
toggl rm <id> # Remove entry by ID
```
### Projects
```bash
toggl project ls # List projects
```
### Other
```bash
toggl web # Open Toggl in browser
toggl create-config # Generate config template
```
## Notes
- Times must be parsable by dayjs (e.g., `4:50PM`, `12:00 AM`, `9:00`)
- Config file: `~/.toggl-cli.json`
- Environment variables override config: `TOGGL_API_TOKEN`, `TOGGL_DEFAULT_WORKSPACE_ID`, `TOGGL_TIMEZONE`
Related in Data & Analytics
clawarr-suite
IncludedComprehensive management for self-hosted media stacks (Sonarr, Radarr, Lidarr, Readarr, Prowlarr, Bazarr, Overseerr, Plex, Tautulli, SABnzbd, Recyclarr, Unpackerr, Notifiarr, Maintainerr, Kometa, FlareSolverr). Deep library exploration, analytics, dashboard generation, content management, request handling, subtitle management, indexer control, download monitoring, quality profile sync, library cleanup automation, notification routing, collection/overlay management, and media tracker integration (Trakt, Letterboxd, Simkl).
querying-soql
IncludedSOQL query generation, optimization, and analysis with 100-point scoring. Use this skill when the user needs SOQL/SOSL authoring or optimization: natural-language-to-query generation, relationship queries, aggregates, query-plan analysis, and performance or safety improvements for Salesforce queries. TRIGGER when: user writes, optimizes, or debugs SOQL/SOSL queries, touches .soql files, or asks about relationship queries, aggregates, or query performance. DO NOT TRIGGER when: bulk data operations (use handling-sf-data), Apex DML logic (use generating-apex), or report/dashboard queries.
app-store-optimization
IncludedApp Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.
habit-flow
IncludedAI-powered atomic habit tracker with natural language logging, streak tracking, smart reminders, and coaching. Use for creating habits, logging completions naturally ("I meditated today"), viewing progress, and getting personalized coaching.
app-store-optimization
IncludedApp Store Optimization (ASO) toolkit for researching keywords, analyzing competitor rankings, generating metadata suggestions, and improving app visibility on Apple App Store and Google Play Store. Use when the user asks about ASO, app store rankings, app metadata, app titles and descriptions, app store listings, app visibility, or mobile app marketing on iOS or Android. Supports keyword research and scoring, competitor keyword analysis, metadata optimization, A/B test planning, launch checklists, and tracking ranking changes.
visualizing-data
IncludedBuilds dashboards, reports, and data-driven interfaces requiring charts, graphs, or visual analytics. Provides systematic framework for selecting appropriate visualizations based on data characteristics and analytical purpose. Includes 24+ visualization types organized by purpose (trends, comparisons, distributions, relationships, flows, hierarchies, geospatial), accessibility patterns (WCAG 2.1 AA compliance), colorblind-safe palettes, and performance optimization strategies. Use when creating visualizations, choosing chart types, displaying data graphically, or designing data interfaces.