@knowsuchagency/fulcrum 1.8.1 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Project Fulcrum
2
2
 
3
- **Harness Attention. Orchestrate Agents. Ship.**
3
+ **Harness Attention. Orchestrate Agents. Leverage Your Time Wisely.**
4
4
 
5
5
  ![Fulcrum Kanban Board](./screenshots/tasks-kanban-board.png)
6
6
 
@@ -25,10 +25,13 @@ Fulcrum supports **Claude Code** and **OpenCode** with per-repository and per-ta
25
25
  - **Work From Anywhere** — Run on a remote server; agents continue working when you disconnect
26
26
  - **Git Worktree Isolation** — Safe experimentation without touching your main branch
27
27
  - **Claude Code Plugin** — Skill for task management, automatic status sync, session continuity
28
- - **MCP Server** — Let Claude manage tasks, list repositories, and send notifications
28
+ - **MCP Server** — 60+ tools for tasks, projects, apps, and remote execution
29
29
  - **Kanban Task Management** — Visual task tracking from planning to done
30
+ - **Task Dependencies** — Define prerequisite tasks; visualize with dependency graph
31
+ - **Task & Project Context** — Attach files, add reference links, set due dates, organize with labels
30
32
  - **PR Monitoring** — Track pull requests across repositories
31
33
  - **Linear Integration** — Sync task status with Linear tickets
34
+ - **Job Scheduling** — Create and manage systemd/launchd timers from the UI
32
35
  - **Cross-Platform** — Desktop app (Mac, Linux) or web application
33
36
 
34
37
  ## Quick Start
@@ -103,7 +106,7 @@ Track tasks from planning to done. Create tasks that automatically spin up isola
103
106
 
104
107
  ### Task Terminals View
105
108
 
106
- See all your AI agent sessions across every task and worktree in a single parallel view. Each task runs in an isolated git worktree, and you can monitor and interact with all of them simultaneously.
109
+ See all your AI agent sessions across every task in a single parallel view. Each task creates an isolated git worktree on-demand, and you can monitor and interact with all sessions simultaneously.
107
110
 
108
111
  ![Task Terminals View](./screenshots/terminals-view-with-tests.png)
109
112
 
@@ -127,7 +130,7 @@ Preview your app alongside the agent terminal in a split-pane view. Watch change
127
130
 
128
131
  ### System Monitoring
129
132
 
130
- Keep an eye on system resources while your agents work. CPU, memory, and disk usage at a glance.
133
+ Keep an eye on system resources while your agents work. CPU, memory, and disk usage at a glance. The Jobs tab lets you create and manage systemd (Linux) or launchd (macOS) timers.
131
134
 
132
135
  ![System Monitoring](./screenshots/monitoring-system-metrics.png)
133
136
 
@@ -174,25 +177,20 @@ fulcrum opencode uninstall # Remove both
174
177
 
175
178
  ## MCP Tools
176
179
 
177
- Both Claude Code and OpenCode plugins include an MCP server that exposes task management and remote execution tools:
180
+ Both Claude Code and OpenCode plugins include an MCP server with 60+ tools for task management, project organization, app deployment, and remote execution:
178
181
 
179
- **Task Management:**
180
- - `list_tasks` — List all tasks with optional status/repo filter
181
- - `get_task` Get task details by ID
182
- - `create_task` Create a new task with git worktree
183
- - `update_task` Update task title/description
184
- - `delete_task` Delete a task
185
- - `move_task` Change task status
186
- - `list_repositories` List configured repositories
187
- - `send_notification` Send notification to enabled channels
182
+ | Category | Description |
183
+ |----------|-------------|
184
+ | **Tasks** | Create, update, move tasks; manage links, labels, attachments, due dates |
185
+ | **Task Dependencies** | Define prerequisite tasks; visualize with dependency graph |
186
+ | **Projects** | Manage projects with tags, notes, and file attachments |
187
+ | **Repositories** | Add, configure, and link repositories to projects |
188
+ | **Apps** | Deploy, stop, and monitor Docker Compose applications |
189
+ | **Filesystem** | Browse directories, read/write files on the Fulcrum server |
190
+ | **Execution** | Run shell commands with persistent session support |
191
+ | **Notifications** | Send notifications to enabled channels |
188
192
 
189
- **Remote Command Execution:**
190
- - `execute_command` — Execute shell commands on the Fulcrum server with persistent session support
191
- - `list_exec_sessions` — List active command execution sessions
192
- - `update_exec_session` — Rename a session
193
- - `destroy_exec_session` — Clean up a session
194
-
195
- The `execute_command` tool supports persistent sessions where environment variables, working directory, and shell state are preserved between commands. Sessions can be given optional names for identification and persist until manually destroyed.
193
+ Use `search_tools` to discover available tools by keyword or category.
196
194
 
197
195
  For Claude Desktop, add to your `claude_desktop_config.json`:
198
196
 
@@ -287,46 +285,29 @@ fulcrum up -y # Start with auto-install (no prompts)
287
285
  fulcrum down # Stop server
288
286
  fulcrum status # Check server status
289
287
  fulcrum doctor # Check all dependencies
290
- fulcrum health # Check server health
291
288
  fulcrum mcp # Start MCP server (stdio)
292
289
  ```
293
290
 
294
291
  ### Current Task (auto-detected from worktree)
295
292
 
296
293
  ```bash
297
- fulcrum current-task # Get current task info
298
- fulcrum current-task in-progress # Mark as IN_PROGRESS
294
+ fulcrum current-task info # Get current task info (default)
299
295
  fulcrum current-task review # Mark as IN_REVIEW
300
296
  fulcrum current-task done # Mark as DONE
301
297
  fulcrum current-task cancel # Mark as CANCELED
302
298
  fulcrum current-task pr <url> # Associate a PR with current task
303
- fulcrum current-task linear <url> # Link to a Linear ticket
304
- ```
305
-
306
- ### Task Management
307
-
308
- ```bash
309
- fulcrum tasks list # List all tasks
310
- fulcrum tasks get <id> # Get task by ID
311
- fulcrum tasks create # Create a new task
312
- fulcrum tasks update <id> # Update a task
313
- fulcrum tasks move <id> # Move task to different status
314
- fulcrum tasks delete <id> # Delete a task
315
- ```
316
-
317
- ### Git Operations
318
-
319
- ```bash
320
- fulcrum git status # Git status for current worktree
321
- fulcrum git diff # Git diff for current worktree
322
- fulcrum git branches # List branches in a repo
299
+ fulcrum current-task link <url> # Add a reference link to the task
300
+ fulcrum current-task link # List all links
301
+ fulcrum current-task link -r <id> # Remove a link
323
302
  ```
324
303
 
325
- ### Worktrees
304
+ ### Agent Integration
326
305
 
327
306
  ```bash
328
- fulcrum worktrees list # List all worktrees
329
- fulcrum worktrees delete # Delete a worktree
307
+ fulcrum claude install # Install Claude Code plugin + MCP server
308
+ fulcrum claude uninstall # Remove plugin + MCP server
309
+ fulcrum opencode install # Install OpenCode plugin + MCP server
310
+ fulcrum opencode uninstall # Remove plugin + MCP server
330
311
  ```
331
312
 
332
313
  ### Configuration
package/bin/fulcrum.js CHANGED
@@ -47082,7 +47082,7 @@ var marketplace_default = `{
47082
47082
  "name": "fulcrum",
47083
47083
  "source": "./",
47084
47084
  "description": "Task orchestration for Claude Code",
47085
- "version": "1.8.1",
47085
+ "version": "1.9.0",
47086
47086
  "skills": [
47087
47087
  "./skills/fulcrum"
47088
47088
  ],
@@ -48195,7 +48195,7 @@ function installUv() {
48195
48195
  var package_default = {
48196
48196
  name: "@knowsuchagency/fulcrum",
48197
48197
  private: true,
48198
- version: "1.8.1",
48198
+ version: "1.9.0",
48199
48199
  description: "Harness Attention. Orchestrate Agents. Ship.",
48200
48200
  license: "PolyForm-Perimeter-1.0.0",
48201
48201
  type: "module",