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.
Files changed (2) hide show
  1. package/README.md +23 -144
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,160 +1,39 @@
1
- # Agent Office - Apple-Inspired Claude Code Visualization
1
+ # Claude Dojo
2
2
 
3
- A beautifully designed visualization plugin for Claude Code that displays agents working in real-time with Apple's signature design aesthetic.
3
+ A visual dashboard for Claude AI - watch agents work in a 3D hex-grid interface.
4
4
 
5
- ## Features
5
+ ## Requirements
6
6
 
7
- ### Design Philosophy
8
- - **Flat Minimalist Design**: Clean, uncluttered interface inspired by Apple's design language
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
- ### Visualization Elements
10
+ ## Setup
15
11
 
16
- #### Agent Cards
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
- open agent-office-plugin.html
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
- ## Integration Ideas
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
- function updateAgentStatus(update) {
118
- const agent = agents.find(a => a.id === update.agentId);
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
- ## Browser Compatibility
129
-
130
- - Chrome/Edge 90+
131
- - Safari 14+
132
- - Firefox 88+
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
- ## Future Enhancements
30
+ ## Keyboard Shortcuts
148
31
 
149
- - [ ] Agent collaboration visualization (connections between agents)
150
- - [ ] Performance metrics dashboard
151
- - [ ] Interactive agent controls (pause, resume, prioritize)
152
- - [ ] Export activity logs
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
- ## Credits
37
+ ## License
159
38
 
160
- Designed with inspiration from Apple's Human Interface Guidelines and macOS Big Sur design language.
39
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-dojo",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "A visual agent dashboard for Claude - watch AI agents work in a 3D hex-grid interface",
5
5
  "type": "module",
6
6
  "bin": {