Skip to content

tokentopapp/agent-windsurf

@tokentop/agent-windsurf

npm CI License: MIT

tokentop agent plugin for Windsurf. Detects installation and provides the plugin scaffold for session tracking.

Status: Scaffold — This plugin detects whether Windsurf is installed but does not yet parse sessions or track usage. Contributions welcome!

Capabilities

Capability Status
Session parsing Not yet
Credential reading Not yet
Real-time tracking Not yet
Multi-provider No

What Works Today

  • Installation detection — tokentop can detect if Windsurf is installed by checking for ~/.windsurf
  • Plugin registration — the agent appears in tokentop's plugin list

What Needs Implementation

Session parsing, credential reading, and real-time file watching need to be built. See @tokentop/agent-opencode for a complete reference implementation.

If you use Windsurf and want to help, check the Contributing Guide — this is a great first contribution.

Install

This plugin is bundled with tokentop — no separate install needed. If you need it standalone:

bun add @tokentop/agent-windsurf

Requirements

  • Windsurf installed
  • Bun >= 1.0.0
  • @tokentop/plugin-sdk ^1.0.0 (peer dependency)

Permissions

Type Access Paths
Filesystem Read ~/.windsurf

Development

bun install
bun run build
bun test
bun run typecheck

Contributing

See the Contributing Guide. Issues for this plugin should be filed on the main tokentop repo.

License

MIT

About

tokentop agent plugin for Windsurf — session parsing, credential discovery, and real-time cost tracking for Codeium's editor

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors