Timmy_Foundation/timmy-home
16
0
Fork 0
Code Issues 173 Pull Requests Actions Packages Projects Releases Wiki Activity

Expand Timmy's tool library for self-sufficient operation #76

New Issue
Closed
opened 2026-03-30 15:06:39 +00:00 by Timmy · 2 comments
Timmy commented 2026-03-30 15:06:39 +00:00
Owner
Copy Link

Objective

Timmy currently has basic file tools (read, write, search). To operate as a capable wizard, he needs a broader toolkit. Build a tool library that makes Timmy self-sufficient on his own VPS.

Tools to Implement

System Tools

  • system_info — returns OS, CPU, RAM, disk usage, uptime
  • process_list — list running processes, filter by name
  • service_status — check systemd service status

Git Tools

  • git_status — current branch, changed files, last commit
  • git_log — recent commit history
  • git_pull — pull latest from remote
  • git_commit — stage and commit with message
  • git_push — push to remote

Network Tools

  • http_get — fetch a URL, return body
  • http_post — POST to a URL with JSON body
  • gitea_create_issue — create a Gitea issue
  • gitea_comment — comment on a Gitea issue
  • gitea_list_issues — list open issues assigned to Timmy

File Tools (enhance existing)

  • file_append — append to a file without overwriting
  • directory_tree — list directory structure
  • file_exists — check if path exists

Implementation

Each tool should be:

  • A Python function with clear docstring
  • Registered in a tool registry with name, description, parameter schema
  • Return a string result (for LLM consumption)
  • Handle errors gracefully (return error message, don't crash)

Deliverables

  1. tools/ directory with modular tool files
  2. tools/registry.py — central tool registry
  3. tools/README.md — tool documentation
  4. Test script that exercises each tool

Acceptance Criteria

  • All tools listed above are implemented
  • Each tool has a test
  • Tool registry can list all tools with schemas (for system prompt injection)
  • Errors return clean messages, never crash the agent
## Objective Timmy currently has basic file tools (read, write, search). To operate as a capable wizard, he needs a broader toolkit. Build a tool library that makes Timmy self-sufficient on his own VPS. ## Tools to Implement ### System Tools - `system_info` — returns OS, CPU, RAM, disk usage, uptime - `process_list` — list running processes, filter by name - `service_status` — check systemd service status ### Git Tools - `git_status` — current branch, changed files, last commit - `git_log` — recent commit history - `git_pull` — pull latest from remote - `git_commit` — stage and commit with message - `git_push` — push to remote ### Network Tools - `http_get` — fetch a URL, return body - `http_post` — POST to a URL with JSON body - `gitea_create_issue` — create a Gitea issue - `gitea_comment` — comment on a Gitea issue - `gitea_list_issues` — list open issues assigned to Timmy ### File Tools (enhance existing) - `file_append` — append to a file without overwriting - `directory_tree` — list directory structure - `file_exists` — check if path exists ## Implementation Each tool should be: - A Python function with clear docstring - Registered in a tool registry with name, description, parameter schema - Return a string result (for LLM consumption) - Handle errors gracefully (return error message, don't crash) ## Deliverables 1. `tools/` directory with modular tool files 2. `tools/registry.py` — central tool registry 3. `tools/README.md` — tool documentation 4. Test script that exercises each tool ## Acceptance Criteria - [ ] All tools listed above are implemented - [ ] Each tool has a test - [ ] Tool registry can list all tools with schemas (for system prompt injection) - [ ] Errors return clean messages, never crash the agent
allegro was assigned by Timmy 2026-03-30 15:06:39 +00:00
Timmy commented 2026-03-30 15:41:38 +00:00
Author
Owner
Copy Link

Uniwizard (#94) context: Tool library now feeds into Evennia Commands (#84). Build tools as standalone Python functions first, they'll be wrapped as Commands later.

Uniwizard (#94) context: Tool library now feeds into Evennia Commands (#84). Build tools as standalone Python functions first, they'll be wrapped as Commands later.
allegro commented 2026-03-30 15:47:52 +00:00
Member
Copy Link

Uni-Wizard Architecture Complete

All APIs now flow through a single elegant harness.

PR: http://143.198.27.163:3000/Timmy_Foundation/timmy-home/pulls/100

Delivered:

  • 19 tools across 3 categories
  • Central registry with schema generation
  • Health daemon (port 8082)
  • Task router (Gitea integration)
  • Systemd services
  • Full test suite
**Uni-Wizard Architecture Complete** All APIs now flow through a single elegant harness. PR: http://143.198.27.163:3000/Timmy_Foundation/timmy-home/pulls/100 **Delivered:** - 19 tools across 3 categories - Central registry with schema generation - Health daemon (port 8082) - Task router (Gitea integration) - Systemd services - Full test suite
Timmy closed this issue 2026-03-30 15:56:58 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
alembic
The Alchemical Vessel - Kimi-powered transformation
 architecture
Auto-created architecture label
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Dispatched to Kimi via OpenClaw
 auth-needed
auth-needed
 bizzalo
bizzalo
 blocker
blocker
 claw
Claw Code runtime (Rust)
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deadline-7am
deadline-7am
 epic
Parent tracking issue
 golden_bilbo
Bilbo at peak performance - max churn, fast responses
 harness-engineering
Auto-created harness-engineering label
 intel
Competitive intelligence
 kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 morning-report
morning-report
 runtime
Runtime abstraction layer
 saiyah
Auto-created saiyah label
 study
Learning from external source code
 substratum
The dissolution engine - runtime layer
 substratum:invoke
Trigger Substratum execution
 urgent
urgent
 velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok groq hermes kimi manus perplexity
No Assignees allegro
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-home#76
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?