@basestream/cli
v0.6.1
Published
AI work intelligence for teams — automatic work tracking for Claude Code
Readme
Basestream
Your team uses AI every day. Now you can see what it's building.
Basestream automatically tracks what your developers build with AI tools and gives engineering leaders visibility into AI-powered output — no manual logging, no workflow changes.
Install
npx @basestream/cli initBasestream is also available via Homebrew:
brew tap basement-browser/basestream
brew install basestream
basestream initUpdate
# npm
npx @basestream/cli@latest init
# Homebrew
brew upgrade basestreamThis will:
- Authenticate with your Basestream account
- Configure automatic session tracking
- Auto-link the current repo to your org
- Start capturing work in the background
How it works
Basestream runs silently alongside your AI tools. At the end of each session, it captures what was built — files changed, commits made, tools used, token usage — and syncs it to your dashboard.
No prompts. No interruptions. No behavior changes required.
Org-aware tracking
Basestream automatically detects which org a repo belongs to. Sessions in org repos show up on that org's dashboard. Personal projects stay separate.
When you run basestream init or start your first session in a new repo, Basestream checks the server for existing activity and auto-links the repo to the right org. You can also manage this manually:
basestream link # Auto-detect org from server
basestream link <orgId> # Link to a specific org
basestream link --personal # Mark as personal (not sent to any org)
basestream link --list # Show all repo-to-org mappings
basestream link --remove # Remove mapping for current repoSupported tools
- Claude Code
- Cursor
- GitHub Copilot
- More coming soon
Commands
basestream init # Detect AI tools, inject hooks, authenticate
basestream login # Authenticate with your Basestream account
basestream link # Link current repo to an org (auto-detects)
basestream skills # Detect stack & recommend/install contextual skills
basestream status # Interactive dashboard (sessions, cost, skills)
basestream status --simple # Show plain text summary
basestream sync # Manually sync buffered entries to Basestream
basestream uninstall # Remove the Claude Code tracking hookDashboard
Your team's AI work shows up at basestream.ai/dashboard:
- Overview — Activity feed, heatmap, quick stats
- Team — Who's building what, output by person
- Projects — Work grouped by repository (scoped to your org)
- Scores — Performance metrics weighted by role
- Cost Intelligence — Token spend, tool adoption, before/after efficiency
- ROI — Cost per outcome, hours saved, completion rates
- Integrations — Connect GitHub, Jira, Notion, Google Calendar, and more
Plans
| Plan | Price | For | | ---------- | ----------- | ----------------------------------- | | Personal | Free | Individual developers | | Team | $12/user/mo | Engineering teams | | Enterprise | Custom | Organizations with compliance needs |
Privacy
- Work entries are scoped to your organization
- Personal repos are never sent to org dashboards
- Visibility controls: private, team, or public per entry
- No source code is ever captured — only metadata
- API keys are scoped per user, revocable anytime
Support
Built by Sublevel Inc.
