Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
8ec367a
Add Bash CLI core framework for Subtext MCP server
chiplay Apr 7, 2026
54fdc44
Fix code review issues in subtext-cli.sh
chiplay Apr 7, 2026
2710221
Add browser control commands to CLI (connect, disconnect, snapshot, e…
chiplay Apr 7, 2026
52f29b8
Add interaction commands to CLI (click, fill, hover, keypress, drag, …
chiplay Apr 7, 2026
a784042
Add observation and utility commands to CLI (eval, logs, network, too…
chiplay Apr 7, 2026
58b8cc8
Add Node.js SDK project setup and transport layer
chiplay Apr 7, 2026
41e4d4b
Add SubtextClient class wrapping transport layer into ergonomic methods
chiplay Apr 7, 2026
74e5224
Add Node.js CLI entry point with yargs command registration
chiplay Apr 7, 2026
91c8eaa
Add CLI smoke tests for help, version, error handling, and API key va…
chiplay Apr 7, 2026
b063efb
docs: add CLI section to README
chiplay Apr 7, 2026
e3ff1f7
fix: move yargs to dependencies, exclude tests from npm package, add …
chiplay Apr 7, 2026
9e451aa
Fix JSON injection, unhandled errors, and missing error checks
chiplay Apr 7, 2026
89b86d2
chore: rename package to @fullstorydev/subtext-cli, add plan docs
chiplay Apr 7, 2026
909f300
chore: remove plan doc from PR
chiplay Apr 7, 2026
c6cd0b2
chore: add js-yaml dependency for sightmap YAML parsing
chiplay Apr 8, 2026
10d9fae
feat(sdk): add sightmap module — discovery, parsing, flattening, upload
chiplay Apr 8, 2026
9a9a31a
feat: add localhost URL detection for tunnel routing
chiplay Apr 8, 2026
138d68a
feat: add hook system with post-connect sightmap upload
chiplay Apr 8, 2026
4ba96d8
feat: enhance SubtextClient with hooks and sightmap auto-upload on co…
chiplay Apr 8, 2026
5640946
feat: add --no-hooks flag and sightmap CLI commands
chiplay Apr 8, 2026
95b6ad0
chore: bump version to 0.2.0 for sightmap + hooks release
chiplay Apr 8, 2026
af8a941
feat: add tunnel proxy for localhost HTTP proxying
chiplay Apr 8, 2026
1dd059a
feat: auto-tunnel on connect for localhost URLs
chiplay Apr 8, 2026
28b3b1f
fix: parse JSON relayUrl from live-tunnel response (was looking for w…
chiplay Apr 8, 2026
e58bbde
feat: add ws fallback for Node 20 WebSocket compatibility
chiplay Apr 8, 2026
bb26a72
fix: use createRequire for ws fallback in ESM context
chiplay Apr 8, 2026
578c4a1
fix: component IDs, sightmap warnings, API key compat, screenshot --o…
chiplay Apr 8, 2026
bea7581
feat: add README, get-skill command, and embedded agent skill
chiplay Apr 8, 2026
289a5de
feat: add README, get-skill command, and embedded agent skill
chiplay Apr 8, 2026
6e8ab26
chore: remove stray files, add gitignore for build artifacts
chiplay Apr 8, 2026
c009760
chore: rename package to @subtextdev/subtext-cli for npm publish
chiplay Apr 8, 2026
3750981
fix: comment-add uses 'text' not 'body', fix --no-tunnel flag
chiplay Apr 8, 2026
da727c4
fix: exit non-zero when MCP tool returns error
chiplay Apr 8, 2026
9ccca64
feat: add 'comments watch' command for real-time comment polling
chiplay Apr 8, 2026
7a6eec3
feat: add 'comments watch' command for real-time comment polling
chiplay Apr 8, 2026
cad5c32
feat: add embed-token CLI command for minting playback tokens
chiplay Apr 9, 2026
d6fc832
feat: add dialog, upload, review, and comment CLI commands
chiplay Apr 9, 2026
5313c7d
feat: add dialog, upload, review, and comment CLI commands (0.3.1)
chiplay Apr 9, 2026
91e3061
fix: correct review command signatures (timestamps, client_id, use_case)
chiplay Apr 9, 2026
81d5491
fix: v0.3.3 — emulate param, exit codes, remove embed-token and stray…
chiplay Apr 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,3 +3,44 @@
[Subtext](https://subtext.fullstory.com/) agent plugin.

See the [install guide](https://subtext.fullstory.com/install/) for installation and usage.

## CLI

Subtext is also available as a standalone CLI for use outside of AI agents.

### Bash CLI

A single-file bash script wrapping all MCP tools. Requires bash, curl, and python3.

```bash
# Install
cp tools/subtext-cli.sh /usr/local/bin/subtext
chmod +x /usr/local/bin/subtext

# Usage
export SECRET_SUBTEXT_API_KEY='your-api-key'
subtext connect https://example.com
subtext click <conn_id> 95
subtext disconnect <conn_id>
```

### Node.js CLI / SDK

A publishable npm package with both a CLI and a programmatic SDK.

```bash
# Install globally
npm install -g @fullstorydev/subtext-cli

# CLI usage
export SECRET_SUBTEXT_API_KEY='your-api-key'
subtext connect https://example.com

# SDK usage
import { SubtextClient } from "@fullstorydev/subtext-cli";

const client = new SubtextClient({ apiKey: process.env.SECRET_SUBTEXT_API_KEY });
const result = await client.connect("https://example.com");
```

Run `subtext --help` for the full command reference.
6 changes: 6 additions & 0 deletions cli/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
build/
node_modules/
*.tgz
*.zip
package/
docs/plans/
Loading