System + scheduling tools

Messaging, scheduling, system utilities, and secure secrets.

#Messaging

ToolDescription
send_telegram_messageSend a message to a Telegram user by ID

#Scheduler

ToolDescription
schedule_taskSchedule a one-shot or recurring cron task
list_tasksList all scheduled tasks
cancel_taskCancel a scheduled task by ID

#System

ToolDescription
get_current_timeReturn current datetime and timezone
delegate_taskDelegate a focused sub-task to a fresh agent instance and return its result
spawn_agentSpawn a specialized sub-agent (researcher, coder, reviewer) with an optional tool allowlist
notifySend a native desktop notification (macOS, Linux, Windows)
clipboard_readRead the current system clipboard contents
clipboard_writeWrite text to the system clipboard
sleepWait for N seconds (use sparingly)

#Secrets Vault

Tota stores secrets in the OS keychain (macOS Keychain, GNOME Keyring, Windows Credential Manager) and falls back to an AES-256-GCM encrypted file at ~/.tota/vault.enc.json.

ToolDescription
secret_storeStore a secret by name
secret_getRetrieve a secret by name
secret_listList all stored secret names
secret_deleteDelete a secret by name
Store my GitHub PAT as "github_token"
> secret_store name=github_token value=ghp_xxx

Retrieve it later
> secret_get name=github_token

#Multi-Agent Crew

spawn_agent runs a sub-agent with a focused role and an optional tool allowlist, then returns its output.

Spawn a researcher agent to summarize today's AI news
> spawn_agent role=researcher task="Summarize the top 3 AI news stories from today" tools=fetch_url,web_search

Spawn a code reviewer
> spawn_agent role=reviewer task="Review the diff in /tmp/patch.diff and list issues" tools=read_file