Skip to content

ikangai/employee

v0.1.1

Self-service assistant for a running IKANGAI Signals instance: book and submit your timesheet, request leave, file expenses, and see what's on your plate — via a bundled remote MCP connector (OAuth), no CLI required.

GitHubOpen Website

employee — IKANGAI Signals Employee Assistant (Claude plugin)

Turns a Claude Code, Claude Desktop or ChatGPT session into a self-service assistant on a running IKANGAI Signals instance. Four workflows over a bundled remote MCP connector (signals → https://signals.ikangai.com/mcp) — no CLI:

CommandWhat it does
/employee:timesheet [date|last]Your week per project and day; books the hours you state, fixes rejected entries, submits
/employee:leave [type and dates]Leave balances and history; files a leave request
/employee:expenses [description]Your expense claims; records new ones as drafts, submits
/employee:my-workWork items assigned to you plus timesheet obligations; moves a status

All four also trigger from natural language ("book 8 hours on PRJ-104 yesterday"). The shared signals-operating skill (a copy of pmo's — see plugins/pmo/README.md → Tests) handles the connector tools, the preflight and the write-safety policy.

Prerequisites

  • A running IKANGAI Signals instance with the remote MCP + OAuth surface.
  • Your own account, authorized in the browser when the connector first asks. Everything is about your own data.

Write safety

  • Tier 0: reads — free.
  • Tier 1 (autonomous, dryRun: true first): your own Draft timesheet entries and Draft expense claims, only with the hours/amounts you state.
  • Tier 2 (confirmed per action): submitting a timesheet or expense, requesting leave, changing a work item's status, deletes.

Install

Published in the public marketplace ikangai/claude-plugins. After installing, connect the signals connector once (browser sign-in to IKANGAI Signals).

  • Claude Code: /plugin marketplace add ikangai/claude-plugins, then /plugin install employee@ikangai. From a clone of this repo: /plugin marketplace add . then /plugin install employee; one session only: claude --plugin-dir ./plugins/employee/.
  • Claude Desktop: Customize → Plugins → Add → Add marketplace → ikangai/claude-plugins, install employee, then open its Connectors tab and connect signals. Team/Enterprise: an Owner syncs the repo under Organization settings → Plugins & skills (and can set it Installed by default); each member still connects. Skills work in chat and Cowork.
  • ChatGPT desktop: the plugin root also carries the portable plugin.json + mcp.json (agent-plugins.org 1.0.0). Workspace: an admin imports the repo under Admin → Plugins and publishes it to the roles that need it. Personal: clone ikangai/claude-plugins, copy employee/ to ~/.codex/plugins/employee/, list it in ~/.agents/plugins/marketplace.json, restart the app, install from the Plugins Directory. ChatGPT runs OAuth on install.

Tests

node --test plugins/tests/*.test.mjs — shared with pmo and pm.