ss/AGENTS.md

AGENTS.md

Overview

This document describes the autonomous agents, subagents, and their roles within the scientific-surfing project.

---

Agent List

1. SubscriptionManager Agent

• Purpose: Handles all subscription-related operations, including adding, refreshing, deleting, renaming, and activating subscriptions.
• Key Methods:
  • add_subscription
  • refresh_subscription
  • delete_subscription
  • rename_subscription
  • set_subscription_url
  • activate_subscription
  • list_subscriptions
• Notes: Supports backup option on refresh.

2. StorageManager Agent

• Purpose: Manages persistent storage for configuration and subscription data.
• Key Methods:
  • load_subscriptions
  • save_subscriptions
  • load_config
  • get_storage_info

3. CoreConfigManager Agent

• Purpose: Handles core configuration management, including import/export, editing, resetting, and applying configuration.
• Key Methods:
  • import_config
  • export_config
  • edit_config
  • reset_config
  • show_config
  • apply

4. CoreManager Agent

• Purpose: Manages core components and system service operations (install, uninstall, start, stop, restart, reload, status, update).
• Key Methods:
  • install_service
  • uninstall_service
  • start_service
  • stop_service
  • restart_service
  • reload_service
  • get_service_status
  • update

5. HookManager Agent

• Purpose: Manages hook scripts for automation and customization.
• Key Methods:
  • init
  • list_hooks
  • edit
  • rm

---

Agent Interactions

• The CLI acts as the orchestrator, parsing user commands and delegating tasks to the appropriate agent.
• Agents interact via method calls and shared data models.

---

Extending Agents

• To add a new agent, implement a new manager class and update the CLI to route commands.
• Document new agents and their responsibilities in this file.

---

Last updated

May 26, 2026