convez.ai
Skill
timesheetIO

timesheet-plugin

timesheetIO/timesheet-plugin

Ver no GitHub
InicialPluginScore · de 0 a 100

Official timesheet.io Claude Code plugin / Agent Skill: track time and manage projects, tasks, absences, contracts, expenses, todos, and team data via the @timesheet/cli command-line tool.

Instalação

$npx convez-ai timesheetIO/timesheet-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 3 dias
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Timesheet CLI Skill

skills.sh

A Claude Code plugin (and portable agentic skill) for controlling timesheet.io time tracking through the @timesheet/cli command-line tool. The skill gives any skills-aware agent (Claude Code, Clawdbot, or anything that loads SKILL.md files) structured knowledge of every CLI command, flag, and common workflow.

Prerequisites

Install the CLI globally:

npm install -g @timesheet/cli

Authenticate once via OAuth:

timesheet auth login

Or set an API key for automation:

export TIMESHEET_API_KEY=ts_your.apikey

Installation

Claude Code

Recommended: install from the plugin marketplace.

/plugin marketplace add timesheetIO/timesheet-plugin
/plugin install timesheet@timesheet

This repository is a self-contained marketplace: .claude-plugin/marketplace.json lists a single plugin whose source is the repo root, so adding the marketplace and installing the plugin pulls in the skill directly.

Or install from the bundled CLI (no Git access required):

timesheet skill install            # ~/.claude/skills/timesheet
timesheet skill install --project  # ./.claude/skills/timesheet
timesheet skill install --force    # overwrite if present

Or copy manually:

mkdir -p ~/.claude/skills
cp -r skills/timesheet ~/.claude/skills/

After install, invoke with /timesheet or let the model pick it up from natural-language requests.

Clawdbot

Workspace skills:

cp -r skills/timesheet <your-workspace>/skills/

User skills:

cp -r skills/timesheet ~/.clawdbot/skills/

Or, with the CLI installed: timesheet skill install --clawdbot.

Or register via extraDirs in ~/.clawdbot/clawdbot.json:

{
  "skills": {
    "load": {
      "extraDirs": ["/path/to/this/skills"]
    }
  }
}

Any agent (skills.sh CLI)

Install into any supported agent (Claude Code, Codex, Cursor, OpenCode, and more) with the skills CLI:

npx skills add timesheetIO/timesheet-plugin

Other agents

Any tool that reads a single SKILL.md with YAML frontmatter can consume the skill. Point it at skills/timesheet/SKILL.md and the agent gets the full command reference.

Usage

As a slash command

/timesheet

Natural language

  • "Start a timer for project X"
  • "What is my timer status?"
  • "Show my tasks for today"
  • "Create an expense of 42 EUR on task "
  • "Approve the pending absence "
  • "List my organizations and their members"

Capabilities

CategoryCommands
Authlogin, logout, status, apikey
Timerstart, stop, pause, resume, status, update
Taskslist, show, create, update, delete
Projectslist, show, create, update, delete, members (list/add/update/remove)
Teamslist, members (list/add/update/remove/status)
Organizationslist, show, create, update, delete, members (list/show/add/update/remove)
Contractslist, show, create, update, delete, activate, suspend, reactivate, terminate
Absenceslist, show, create, update, delete, approve, reject, cancel
Absence typeslist, show, create, update, delete
Todoslist, show, create, update, close, reopen, delete
Tagslist, show, create, update, delete
Noteslist, show, create, update, delete, file-url
Expenseslist, show, create, update, delete, refund, file-url
Pauseslist, show, create, update, delete
Rateslist, show, create, update, delete
Reportssummary, export
Profileshow, update, settings, settings-update
Configshow, set, reset

Plugin structure

timesheet-plugin/
├── .claude-plugin/
│   ├── marketplace.json  # marketplace catalog (one plugin, source ".")
│   └── plugin.json       # Claude Code plugin manifest
├── skills/
│   └── timesheet/
│       └── SKILL.md      # YAML frontmatter + command reference
└── README.md

Configuration

Configure environment per agent. Example for Clawdbot:

{
  "skills": {
    "entries": {
      "timesheet": {
        "enabled": true,
        "env": {
          "TIMESHEET_API_KEY": "ts_your.apikey"
        }
      }
    }
  }
}

For Claude Code, export TIMESHEET_API_KEY in your shell profile or rely on timesheet auth login.

Links

License

MIT

Ver o original no GitHub

Bom para

Relacionados