Skip to content

Commit a189db2

Browse files
committed
Website improvements
1 parent 0537674 commit a189db2

File tree

3 files changed

+120
-200
lines changed

3 files changed

+120
-200
lines changed

.github/workflows/deploy.yml

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
name: Build and Deploy to Tigris
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
- feature/agent-tracker-docs
8+
pull_request:
9+
branches:
10+
- main
11+
12+
jobs:
13+
build:
14+
name: Build Documentation
15+
runs-on: ubuntu-latest
16+
17+
steps:
18+
- name: Checkout code
19+
uses: actions/checkout@v4
20+
21+
- name: Setup Node.js
22+
uses: actions/setup-node@v4
23+
with:
24+
node-version: '20'
25+
cache: 'npm'
26+
cache-dependency-path: website/package-lock.json
27+
28+
- name: Install dependencies
29+
working-directory: ./website
30+
run: npm ci
31+
32+
- name: Build website
33+
working-directory: ./website
34+
run: npm run build
35+
36+
- name: Upload build artifacts
37+
uses: actions/upload-artifact@v4
38+
with:
39+
name: website-build
40+
path: website/build/
41+
retention-days: 1
42+
43+
deploy:
44+
name: Deploy to Tigris
45+
runs-on: ubuntu-latest
46+
needs: build
47+
if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/feature/agent-tracker-docs')
48+
49+
environment:
50+
name: production
51+
url: https://pipie-static.fly.storage.tigris.dev/agent-tracker/
52+
53+
steps:
54+
- name: Download build artifacts
55+
uses: actions/download-artifact@v4
56+
with:
57+
name: website-build
58+
path: build/
59+
60+
- name: Deploy to Tigris S3
61+
env:
62+
AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
63+
AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
64+
AWS_ENDPOINT_URL_S3: ${{ vars.AWS_ENDPOINT_URL_S3 }}
65+
AWS_REGION: ${{ vars.AWS_REGION }}
66+
BUCKET_NAME: ${{ vars.BUCKET_NAME }}
67+
run: |
68+
# Sync static assets with longer cache
69+
aws s3 sync build/ s3://${BUCKET_NAME}/agent-tracker/ \
70+
--delete \
71+
--cache-control "public, max-age=3600" \
72+
--exclude "*.html" \
73+
--exclude "*.xml" \
74+
--exclude "sitemap.txt"
75+
76+
# Sync HTML files with shorter cache
77+
aws s3 sync build/ s3://${BUCKET_NAME}/agent-tracker/ \
78+
--delete \
79+
--cache-control "public, max-age=300" \
80+
--exclude "*" \
81+
--include "*.html" \
82+
--include "*.xml" \
83+
--include "sitemap.txt"
84+
85+
echo "✅ Deployed to https://pipie-static.fly.storage.tigris.dev/agent-tracker/"

website/docs/roadmap.md

Lines changed: 24 additions & 199 deletions
Original file line numberDiff line numberDiff line change
@@ -4,83 +4,49 @@ sidebar_position: 4
44

55
# Roadmap
66

7-
Agent Tracker is designed to eventually support multiple AI coding agents, not just Claude Code. This page outlines our vision for multi-agent support and future enhancements.
7+
Agent Tracker is designed to support multiple AI coding agents. This page outlines our current support and planned features.
88

9-
## Vision
9+
## Current Support
1010

11-
**Make it easy to track and manage all your AI coding assistants in one unified dashboard.**
12-
13-
Whether you're using Claude Code, Cursor, Windsurf, Aider, or any other AI agent, Agent Tracker should provide a consistent, beautiful interface for monitoring your sessions.
14-
15-
## Multi-Agent Support
16-
17-
### Current Support
18-
19-
#### ✅ Claude Code (Full Support)
11+
### ✅ Claude Code (Full Support)
2012

2113
- Real-time session tracking via plugin hooks
2214
- Activity monitoring (tool use, prompts, responses)
2315
- Transcript viewing
2416
- Rich context capture (git, terminal, docker)
2517

26-
### Planned Agent Support
27-
28-
#### 🔄 Cursor (Planned)
29-
30-
**Status:** In planning
31-
32-
**Approach:**
33-
- Investigate Cursor's extension API
34-
- Create event adapter for Cursor sessions
35-
- Map Cursor events to Agent Tracker format
36-
37-
**Challenges:**
38-
- Cursor uses VS Code extension model
39-
- May need different integration approach than CLI hooks
40-
41-
#### 🔄 Windsurf (Planned)
42-
43-
**Status:** Research phase
44-
45-
**Approach:**
46-
- Investigate Windsurf's architecture
47-
- Determine event capture mechanism
48-
- Create Windsurf-specific adapter
18+
## Planned Agent Support
4919

50-
#### 🔄 Aider (Planned)
20+
### 🔄 AMP (Planned)
5121

52-
**Status:** Research phase
22+
**Status:** Planning
5323

5424
**Approach:**
55-
- Aider is CLI-based, similar to Claude Code
56-
- May be able to wrap Aider commands
57-
- Capture events from Aider's output or config
58-
59-
**Potential:**
60-
- Easier integration due to CLI nature
61-
- Could be our second supported agent
25+
- Investigate AMP's event capture mechanism
26+
- Create event adapter for AMP sessions
27+
- Map AMP events to Agent Tracker format
6228

63-
#### 🔄 Continue.dev (Planned)
29+
### 🔄 Gemini CLI (Planned)
6430

65-
**Status:** Research phase
31+
**Status:** Planning
6632

6733
**Approach:**
68-
- VS Code extension, similar challenges to Cursor
69-
- Investigate Continue's API/events
70-
- Create event adapter
34+
- CLI-based integration, similar to Claude Code
35+
- Capture events from Gemini CLI output or hooks
36+
- Transform to unified event format
7137

72-
#### 🔄 Cody (Planned)
38+
### 🔄 Codex CLI (Planned)
7339

74-
**Status:** Research phase
40+
**Status:** Planning
7541

7642
**Approach:**
77-
- Sourcegraph's AI assistant
78-
- Multiple IDE support
79-
- Research event capture options
43+
- CLI-based integration
44+
- Wrap Codex commands or capture via hooks
45+
- Adapt events to Agent Tracker format
8046

81-
### Integration Architecture
47+
## Integration Architecture
8248

83-
We're designing a flexible adapter pattern to support multiple agents:
49+
Agent Tracker uses a flexible adapter pattern:
8450

8551
```
8652
┌─────────────────────────────────────────────────┐
@@ -96,7 +62,7 @@ We're designing a flexible adapter pattern to support multiple agents:
9662
┌──────────────────┼──────────────────┐
9763
│ │ │
9864
┌───▼──────┐ ┌─────▼─────┐ ┌──────▼──────┐
99-
│ Claude │ │ Cursor │ │ Aider
65+
│ Claude │ │ AMP │ │ Gemini
10066
│ Adapter │ │ Adapter │ │ Adapter │
10167
└──────────┘ └───────────┘ └─────────────┘
10268
```
@@ -107,153 +73,12 @@ Each adapter:
10773
- Writes to `sessions.jsonl`
10874
- Includes agent type identifier
10975

110-
### UI Enhancements for Multi-Agent
111-
112-
#### Agent Type Indicators
113-
114-
```
115-
● agent-tracker (claude-code)
116-
● my-app (cursor)
117-
○ api-service (aider)
118-
```
119-
120-
Sessions will show the agent type with distinct:
121-
- Icons
122-
- Colors
123-
- Labels
124-
125-
#### Agent Filtering
126-
127-
Filter sessions by agent type:
128-
- View all agents
129-
- Show only Claude Code sessions
130-
- Show only Cursor sessions
131-
- etc.
132-
133-
#### Agent-Specific Help
134-
135-
The empty state and setup instructions will dynamically show the correct installation guide based on detected/selected agent.
136-
137-
## Feature Roadmap
138-
139-
### Near Term (Next 3 Months)
140-
141-
#### Enhanced iTerm2 Integration
142-
143-
**Status:** Planned ([Issue #28](https://github.com/wakeless/agent-tracker/issues))
144-
145-
Move iTerm2 API integration from hooks to TUI as persistent service:
146-
- ✨ Faster session starts (50ms vs 400ms)
147-
- ✨ Real-time tab name updates
148-
- ✨ Richer metadata from Python API
149-
150-
#### Better Empty State UX
151-
152-
**Status:** In progress
153-
154-
- ✅ Check if events file exists
155-
- ✅ Show installation guide
156-
- 🔄 Detect available agents
157-
- 🔄 Provide agent-specific setup instructions
158-
159-
#### Alerts & Notifications
160-
161-
**Status:** Planned
162-
163-
- Show alert for sessions awaiting input
164-
- Highlight sessions that need attention
165-
- Configurable notification preferences
166-
167-
### Medium Term (3-6 Months)
168-
169-
#### Multi-Agent Support (Phase 1)
170-
171-
- Add support for 2nd agent (likely Aider or Cursor)
172-
- Implement agent adapter pattern
173-
- Add agent type filtering in UI
174-
- Test with users running multiple agents
175-
176-
#### Session Search & Filtering
177-
178-
- Search sessions by directory, git repo, or terminal
179-
- Filter by session state
180-
- Tag sessions manually
181-
182-
#### Session History & Analytics
183-
184-
- View historical sessions (beyond 1-minute retention)
185-
- Session duration tracking
186-
- Most active projects/repos
187-
188-
### Long Term (6+ Months)
189-
190-
#### Multi-Agent Support (Phase 2)
191-
192-
- Support for 5+ agents
193-
- Agent-specific configuration
194-
- Cross-agent session comparison
195-
196-
#### Cloud Sync (Optional)
197-
198-
- Optionally sync sessions to cloud
199-
- View sessions across machines
200-
- Team dashboards
201-
202-
#### LLM Integration
203-
204-
- Ask questions about your sessions
205-
- "Which session was I working on the auth bug?"
206-
- Summarize session activity
207-
208-
#### Workspace Management
209-
210-
- Group sessions by project/workspace
211-
- Save and restore session layouts
212-
- Integration with terminal multiplexers (tmux/screen)
213-
214-
## Terminal Support Roadmap
215-
216-
See [Terminal Support](./terminal-support#planned-terminal-support) for details on planned terminal emulator support:
217-
218-
- Alacritty
219-
- Kitty
220-
- WezTerm
221-
- Windows Terminal
222-
- Enhanced tmux/screen integration
223-
22476
## Contributing
22577

226-
We welcome contributions! Areas where help is needed:
227-
228-
### Research
229-
230-
- Investigate agent event capture mechanisms
231-
- Test integration approaches
232-
- Document agent architectures
233-
234-
### Development
235-
236-
- Build agent adapters
237-
- Add terminal providers
238-
- Improve TUI features
239-
240-
### Testing
241-
242-
- Test on different platforms
243-
- Verify agent integrations
244-
- Report bugs and edge cases
245-
246-
### Documentation
247-
248-
- Write integration guides
249-
- Create tutorials
250-
- Document troubleshooting steps
251-
252-
## Stay Updated
78+
We welcome contributions! Help us build agent adapters, improve the TUI, or enhance documentation.
25379

25480
- ⭐ Star the [GitHub repo](https://github.com/wakeless/agent-tracker)
255-
- 📝 Follow [GitHub Issues](https://github.com/wakeless/agent-tracker/issues) for updates
256-
- 💬 Participate in [Discussions](https://github.com/wakeless/agent-tracker/discussions)
81+
- 📝 Follow [GitHub Issues](https://github.com/wakeless/agent-tracker/issues)
25782

25883
## Next Steps
25984

website/docusaurus.config.ts

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,8 @@ const config: Config = {
5656
// Replace with your project's social card
5757
image: 'img/docusaurus-social-card.jpg',
5858
colorMode: {
59-
respectPrefersColorScheme: true,
59+
defaultMode: 'light',
60+
respectPrefersColorScheme: false,
6061
},
6162
navbar: {
6263
title: 'Agent Tracker',
@@ -111,6 +112,15 @@ const config: Config = {
111112
},
112113
],
113114
},
115+
{
116+
title: 'Developer',
117+
items: [
118+
{
119+
label: 'Pipie',
120+
href: 'https://pipie.io/',
121+
},
122+
],
123+
},
114124
],
115125
copyright: `Copyright © ${new Date().getFullYear()} Agent Tracker. Built with Docusaurus.`,
116126
},

0 commit comments

Comments
 (0)