Implement management API #26

Merged

albert merged 15 commits from u/albert/24/api into main 2026-05-01 03:49:56 +00:00

Conversation 3 Commits 15 Files changed 63 +6894 -165

albert commented 2026-04-29 04:46:59 +00:00

Owner

Copy link

This change implements a management API and Web interface with the following features:

• Show the current running activity
• Adjust the amount of time remaining for the current activity, or stop it altogether
• List all configured activities
• Explicitly enable or disable a given activity today, overriding any rule-based conditions
• Adjust the volume
• View per-activity daily usage statistics

This is accessible from the local network only.

Configuration rewriting is not implemented in this PR as the API is only optionally authenticated. This compromise was needed to avoid an out-of-the-box RCE vulnerability (even if it's limited to the local network).

Fixes #24

This change implements a management API and Web interface with the following features: * Show the current running activity * Adjust the amount of time remaining for the current activity, or stop it altogether * List all configured activities * Explicitly enable or disable a given activity today, overriding any rule-based conditions * Adjust the volume * View per-activity daily usage statistics This is accessible from the local network only. Configuration rewriting is not implemented in this PR as the API is only optionally authenticated. This compromise was needed to avoid an out-of-the-box RCE vulnerability (even if it's limited to the local network). Fixes #24

albert added 8 commits 2026-04-29 04:46:59 +00:00

Add management API 9227a58c12

WIP: Add management UI PoC e2ad00e22e

Enable API at ./run-dev 9031d0fe17

Forward API events to IPC ... 11f07b5e94

This allows the HUD to receive events from the API. Tested with session
adjustments and volume.

Changes now update all Web clients 71e94c215a

Fix enabling and disabling activities for the day ea94c465ab

Use TanStack Query and Axios to clean up effectful fetches 9a16440af8

Delete maintenance mode ... 46e8736c99

It was never specified or implemented

albert added 1 commit 2026-04-29 11:55:20 +00:00

Fix CI 93d6d0373a

albert commented 2026-04-29 12:01:53 +00:00

Author

Owner

Copy link

This is probably worth a mention in the README along with screenshots prior to merge

This is probably worth a mention in the README along with screenshots prior to merge

👍 1

albert commented 2026-04-29 23:43:13 +00:00

Author

Owner

Copy link

The bind option doesn't seem to be working with anything other than 0.0.0.0...

The `bind` option doesn't seem to be working with anything other than 0.0.0.0...

👍 1

albert added 2 commits 2026-04-30 10:45:06 +00:00

Add option to retry network bind until it is available e3abeb9f2a

Don't delete the .gitkeep when building the frontend 27c636d3f2

albert commented 2026-05-01 00:35:57 +00:00

Author

Owner

Copy link

The warnings always seem to obey the original limit from when the activity was started. If the remaining time is changed, they do not update to reflect the new value.

The warnings always seem to obey the original limit from when the activity was started. If the remaining time is changed, they do not update to reflect the new value.

👍 1

albert added 2 commits 2026-05-01 00:36:43 +00:00

Add management UI and API to README 9ab18e1402

pngcrush the rest of the README images e2f7e37fc0

albert added 1 commit 2026-05-01 03:07:12 +00:00

Fix warnings after deadline changes via API 1f7bfe567d

albert added 1 commit 2026-05-01 03:42:10 +00:00

Fix incorrect UTC date usage ... f00b3ea344

For overrides and usage time statistics, we care about today in the
local time zone, not UTC.

albert merged commit 517611a69e into main 2026-05-01 03:49:56 +00:00

albert referenced this pull request from a commit 2026-05-01 03:49:58 +00:00

Merge pull request 'Implement management API' (#26) from u/albert/24/api into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

bug

Something is not working

  

duplicate

This issue or pull request already exists

  

enhancement

New feature

  

future

  

help wanted

Need some help

  

invalid

Something is wrong

  

question

More information is needed

  

wontfix

This won't be fixed

No labels

bug

duplicate

enhancement

future

help wanted

invalid

question

wontfix

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

albert/shepherd-launcher!26

No description provided.