@elyracode/felagi

Elyra Félagi integration for Elyra. Félagi is a project portal where people and agents share one board — this extension puts issues, comments, time tracking, the stopwatch, the knowledge base, projects, and agent runs inside your Elyra session.

Install

elyra install npm:@elyracode/felagi

Setup

Create a token in Félagi under Settings → API tokens and paste the block it hands you into your project's .env (or export the variables):

FELAGI_URL=https://felagi.example.com
FELAGI_TOKEN=fat_...

A read-only token works for everything except writes (which answer 403 with a message saying so).

Tools

| Tool | Description | |------|-------------| | felagi_me | Who the token acts as, its workspace and abilities | | felagi_issues | List/search issues: text, status, type, priority, project, assignee, labels (AND), cycle, updated_since | | felagi_issue | One issue in full, optionally with the comment thread and delivered artifacts | | felagi_create_issue | Create an issue (title required) | | felagi_update_issue | PATCH any subset of fields; assigning an agent queues a run | | felagi_comment | Comment on an issue; mentioning an agent hands it the thread | | felagi_log_time | Log time as a person says it: 2h 30m, 1d, 90m | | felagi_time_entries | Read hours, filtered by mine/date range/issue/source | | felagi_timer | Stopwatch: status, start (switches cleanly), stop, discard | | felagi_articles | Search the team knowledge base; read full articles | | felagi_projects | List projects | | felagi_agents | List assignable agents with runtime status | | felagi_run | Queue an agent run on an issue; list/read runs with summary and cost |

Commands

| Command | Description | |---------|-------------| | /felagi | Dashboard — my issues, running timer, workspace | | /felagi-timer | /felagi-timer start ACM-231, stop, status, discard | | /felagi-log | /felagi-log ACM-231 2h30m traced the redirect loop |

Behavior notes

• Issue references accept both the human identifier (ACM-231) and the numeric id.
• Time durations are written the way a person says them; spent_on defaults to today.
• Hours are always the token owner's own — the API has no actor field for time, deliberately.
• Starting a timer while one runs stops and logs the first; the tool reports what was banked.
• The knowledge base (felagi_articles) is the endpoint worth knowing: the agent reads the team's runbook before it starts.
• API reference: elyracode.com/docs/felagi/api