dwmkerr / dwmkerr/shellwright

rfc: get screenshots / recordings after session end

Open
#18 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
37
Forks
5
Avg merge
3d 23h
Merged PRs (30d)
1

Description

## Summary

Add ability to list and retrieve screenshots/recordings after a shell session ends, useful when:
- LLM forgets filename
- LLM calls `shell_stop` before downloading
- User asks "what screenshots did you take?"

## Proposal

### Option 1: `shell_list_files` tool

```typescript
shell_list_files({
session_id?: string, // Optional - if omitted, list all sessions
type?: "screenshots" | "recordings" | "all" // Default: "all"
})
```

Returns:
```json
{
"files": [
{
"filename": "k9s-services.gif",
"type": "recording",
"download_url": "http://localhost:7498/files/...",
"created_at": "2025-12-17T14:30:00Z",
"size_bytes": 5500000
}
]
}
```

### Option 2: HTTP endpoint

Simple `GET /files` endpoint returning JSON listing of all available files.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.