a digital person for bluesky
cameron.stream
1# Platform-Specific Tool Management
2
3Void can now run on both X (Twitter) and Bluesky platforms. To ensure the correct tools are available for each platform, we've implemented automatic tool management.
4
5## How It Works
6
7When you run `bsky.py` or `x.py`, the bot will automatically:
8
91. **Detach incompatible tools** - Removes tools specific to the other platform
102. **Keep common tools** - Preserves tools that work across both platforms
113. **Ensure platform tools** - Verifies that all required platform-specific tools are attached
12
13## Tool Categories
14
15### Bluesky-Specific Tools
16- `search_bluesky_posts` - Search Bluesky posts
17- `create_new_bluesky_post` - Create new posts on Bluesky
18- `get_bluesky_feed` - Retrieve Bluesky feeds
19- `add_post_to_bluesky_reply_thread` - Reply to Bluesky threads
20- `attach_user_blocks`, `detach_user_blocks` - Manage Bluesky user memory blocks
21- `user_note_append`, `user_note_replace`, `user_note_set`, `user_note_view` - Bluesky user notes
22
23### X-Specific Tools
24- `add_post_to_x_thread` - Reply to X threads
25- `attach_x_user_blocks`, `detach_x_user_blocks` - Manage X user memory blocks
26- `x_user_note_append`, `x_user_note_replace`, `x_user_note_set`, `x_user_note_view` - X user notes
27
28### Common Tools (Available on Both Platforms)
29- `halt_activity` - Stop the bot
30- `ignore_notification` - Ignore specific notifications
31- `annotate_ack` - Add acknowledgment notes
32- `create_whitewind_blog_post` - Create blog posts
33- `fetch_webpage` - Fetch web content
34
35## Manual Tool Management
36
37You can manually manage tools using the `tool_manager.py` script:
38
39```bash
40# List currently attached tools
41python tool_manager.py --list
42
43# Configure tools for Bluesky
44python tool_manager.py bluesky
45
46# Configure tools for X
47python tool_manager.py x
48
49# Specify a different agent ID
50python tool_manager.py bluesky --agent-id "agent-123..."
51```
52
53## Registering New Tools
54
55If tools are missing, you'll need to register them first:
56
57```bash
58# Register Bluesky tools
59python register_tools.py
60
61# Register X tools
62python register_x_tools.py
63```
64
65## Troubleshooting
66
67If tool switching fails:
681. The bot will log a warning and continue with existing tools
692. Check that all required tools are registered using `register_tools.py` or `register_x_tools.py`
703. Verify the agent ID in your config is correct
714. Use `python tool_manager.py --list` to see current tool configuration