claude-dojo 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -144
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,160 +1,39 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Claude Dojo
|
|
2
2
|
|
|
3
|
-
A
|
|
3
|
+
A visual dashboard for Claude AI - watch agents work in a 3D hex-grid interface.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Requirements
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
-
|
|
9
|
-
- **Smooth Animations**: Carefully crafted transitions using Apple's signature easing curves
|
|
10
|
-
- **Typography**: System fonts optimized for clarity and elegance
|
|
11
|
-
- **Color System**: Thoughtfully selected colors that work in both light and dark modes
|
|
12
|
-
- **Responsive**: Adapts seamlessly to different screen sizes
|
|
7
|
+
- Node.js >= 18.0.0
|
|
8
|
+
- Anthropic API key
|
|
13
9
|
|
|
14
|
-
|
|
10
|
+
## Setup
|
|
15
11
|
|
|
16
|
-
|
|
17
|
-
Each agent is represented by a card showing:
|
|
18
|
-
- **Avatar**: Emoji-based representation with animated glow effect when active
|
|
19
|
-
- **Role Badge**: Clear identification of agent type
|
|
20
|
-
- **Status Indicator**: Real-time status (Active, Idle, Thinking) with pulsing dot
|
|
21
|
-
- **Current Task**: What the agent is currently working on
|
|
22
|
-
- **Progress Bar**: Animated progress indicator with shimmer effect
|
|
23
|
-
- **Activity Timeline**: Recent actions with timestamps
|
|
24
|
-
|
|
25
|
-
#### Team Inbox
|
|
26
|
-
- **Message Center**: Consolidated view of important notifications
|
|
27
|
-
- **Badge Counter**: Unread message count
|
|
28
|
-
- **Interactive Items**: Hover effects and smooth transitions
|
|
29
|
-
|
|
30
|
-
## Design Details
|
|
31
|
-
|
|
32
|
-
### Color Palette
|
|
33
|
-
The plugin uses Apple's color system with role-specific colors:
|
|
34
|
-
- **Researcher**: Blue (#007AFF) - Analysis and discovery
|
|
35
|
-
- **Coder**: Purple (#5856D6) - Implementation work
|
|
36
|
-
- **Reviewer**: Green (#34C759) - Quality assurance
|
|
37
|
-
- **Explorer**: Pink (#FF2D55) - Navigation and exploration
|
|
38
|
-
- **Planner**: Teal (#00C7BE) - Strategic planning
|
|
39
|
-
- **Artist**: Orange (#FF9500) - Creative work
|
|
40
|
-
|
|
41
|
-
### Animations
|
|
42
|
-
All animations use Apple's signature timing functions:
|
|
43
|
-
- **Swift**: `cubic-bezier(0.4, 0.0, 0.2, 1)` - For quick interactions
|
|
44
|
-
- **Smooth**: `cubic-bezier(0.25, 0.1, 0.25, 1)` - For graceful transitions
|
|
45
|
-
|
|
46
|
-
### Typography
|
|
47
|
-
Uses the SF Pro system font stack with:
|
|
48
|
-
- Font smoothing for crisp text rendering
|
|
49
|
-
- Negative letter spacing for display sizes
|
|
50
|
-
- Hierarchical font sizes from 11px to 48px
|
|
51
|
-
|
|
52
|
-
## Usage
|
|
53
|
-
|
|
54
|
-
### Opening the Visualization
|
|
55
|
-
|
|
56
|
-
Simply open `agent-office-plugin.html` in any modern web browser:
|
|
12
|
+
Set your Anthropic API key:
|
|
57
13
|
|
|
58
14
|
```bash
|
|
59
|
-
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Or drag the file into your browser window.
|
|
63
|
-
|
|
64
|
-
### Customization
|
|
65
|
-
|
|
66
|
-
#### Adding New Agents
|
|
67
|
-
|
|
68
|
-
Edit the `agents` array in the JavaScript section:
|
|
69
|
-
|
|
70
|
-
```javascript
|
|
71
|
-
{
|
|
72
|
-
id: 'your-agent',
|
|
73
|
-
name: 'Agent Name',
|
|
74
|
-
role: 'Agent Role',
|
|
75
|
-
emoji: '🎯',
|
|
76
|
-
status: 'active', // 'active', 'idle', or 'thinking'
|
|
77
|
-
currentTask: 'Description of current task',
|
|
78
|
-
progress: 45,
|
|
79
|
-
activities: [
|
|
80
|
-
{ time: '1m ago', text: 'Recent activity' },
|
|
81
|
-
{ time: '3m ago', text: 'Previous activity' }
|
|
82
|
-
]
|
|
83
|
-
}
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
#### Custom Color Themes
|
|
87
|
-
|
|
88
|
-
Add a new color theme in the CSS:
|
|
89
|
-
|
|
90
|
-
```css
|
|
91
|
-
.agent-card[data-agent="your-agent"] {
|
|
92
|
-
--agent-color: #YOUR_COLOR;
|
|
93
|
-
--agent-color-light: #LIGHTER_COLOR;
|
|
94
|
-
}
|
|
15
|
+
export ANTHROPIC_API_KEY="your-api-key-here"
|
|
95
16
|
```
|
|
96
17
|
|
|
97
|
-
##
|
|
98
|
-
|
|
99
|
-
### Real-time Updates
|
|
100
|
-
To connect with Claude Code's actual agent system:
|
|
101
|
-
|
|
102
|
-
1. **WebSocket Connection**: Stream agent status updates
|
|
103
|
-
2. **Server-Sent Events**: Push updates from Claude Code
|
|
104
|
-
3. **Polling**: Periodically fetch agent status from an API endpoint
|
|
105
|
-
|
|
106
|
-
### Example Integration Structure
|
|
107
|
-
|
|
108
|
-
```javascript
|
|
109
|
-
// Connect to Claude Code agent system
|
|
110
|
-
const ws = new WebSocket('ws://localhost:8080/agent-status');
|
|
111
|
-
|
|
112
|
-
ws.onmessage = (event) => {
|
|
113
|
-
const agentUpdate = JSON.parse(event.data);
|
|
114
|
-
updateAgentStatus(agentUpdate);
|
|
115
|
-
};
|
|
18
|
+
## Usage
|
|
116
19
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
if (agent) {
|
|
120
|
-
agent.status = update.status;
|
|
121
|
-
agent.currentTask = update.task;
|
|
122
|
-
agent.progress = update.progress;
|
|
123
|
-
renderAgents();
|
|
124
|
-
}
|
|
125
|
-
}
|
|
20
|
+
```bash
|
|
21
|
+
npx claude-dojo
|
|
126
22
|
```
|
|
127
23
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
-
|
|
131
|
-
-
|
|
132
|
-
-
|
|
133
|
-
|
|
134
|
-
Optimized for modern browsers with CSS Grid, custom properties, and smooth animations.
|
|
135
|
-
|
|
136
|
-
## Performance
|
|
137
|
-
|
|
138
|
-
- Lightweight: Pure HTML/CSS/JS, no frameworks
|
|
139
|
-
- Optimized animations using CSS transforms
|
|
140
|
-
- Efficient DOM updates
|
|
141
|
-
- Smooth 60fps animations
|
|
142
|
-
|
|
143
|
-
## Dark Mode
|
|
144
|
-
|
|
145
|
-
Automatically adapts to system preferences using `prefers-color-scheme` media query.
|
|
24
|
+
This starts the server and opens the dashboard in your browser. From there you can:
|
|
25
|
+
- Create and manage Claude sessions
|
|
26
|
+
- Watch agents work in real-time on a 3D hex grid
|
|
27
|
+
- View conversation history and tool executions
|
|
28
|
+
- Track token usage
|
|
146
29
|
|
|
147
|
-
##
|
|
30
|
+
## Keyboard Shortcuts
|
|
148
31
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
-
|
|
152
|
-
|
|
153
|
-
- [ ] Customizable themes
|
|
154
|
-
- [ ] Sound notifications
|
|
155
|
-
- [ ] Real-time code diff viewer
|
|
156
|
-
- [ ] Agent chat/messaging interface
|
|
32
|
+
| Key | Action |
|
|
33
|
+
|-----|--------|
|
|
34
|
+
| `1-9` | Select session by index |
|
|
35
|
+
| `Esc` | Deselect current session |
|
|
157
36
|
|
|
158
|
-
##
|
|
37
|
+
## License
|
|
159
38
|
|
|
160
|
-
|
|
39
|
+
MIT
|