TeamFlow

AI-driven team workflow automation tool for daily standups, handoffs, and cross-team collaboration.

Features

• Team Management - Create and join teams with GitHub-based permissions
• Daily Workflow - Automated start/end day routines with sync and summaries
• Handoff Notes - Generate and share work handoffs with @mentions
• Multi-team Support - Work with multiple teams in parallel
• Multi-device Support - Seamless sync across devices with UTC timestamps
• Claude Code Integration - Native skills for AI-assisted workflows

Installation

npm install -g @arcblock/teamflow

Requires:

• Bun runtime (v1.0+)
• Git
• GitHub CLI (gh) - for team creation/joining

Quick Start

Create a Team (Admin)

# Create team with GitHub repo
teamflow setup myteam MyOrg

# Or create a personal team (local only)
teamflow setup --personal

Join a Team (Member)

teamflow join MyOrg/teamflow-myteam

Daily Workflow

# Start your day - sync repos, check mentions, see handoffs
teamflow start-day

# End your day - create handoff notes, @mention teammates
teamflow end-day

# View team status
teamflow overview

Commands

| Command | Description | |---------|-------------| | teamflow setup <name> [org] | Create a new team | | teamflow setup --personal | Create a personal team | | teamflow join <org/repo> | Join an existing team | | teamflow list | List all configured teams | | teamflow start-day | Start work day | | teamflow end-day | End work day | | teamflow overview | View team overview |

Options

# Specify team(s)
teamflow start-day --team alpha
teamflow start-day --team alpha --team beta
teamflow start-day --team alpha,beta

# End day with note
teamflow end-day --summary "Completed feature X"

# Mention teammates
teamflow end-day --mention alice --mention bob

Claude Code Skills

Use these skills in Claude Code for AI-assisted workflows:

| Skill | Description | |-------|-------------| | /team-setup | Interactive team creation | | /team-join | Join a team with guidance | | /team-start | Morning briefing with AI analysis | | /team-end | End-of-day handoff with suggestions | | /team-overview | Team status summary |

Architecture

TeamFlow separates code from data:

~/.teamflow/              # Local configuration
└── config.yaml           # Team list and settings

teamflow-{team}/          # Team data repo (GitHub)
├── config/
│   └── team.yaml         # Team configuration
├── daily/{date}/
│   ├── handoffs/         # Daily handoff notes
│   └── mentions/         # @mention notifications
├── members/{id}/
│   ├── profile.yaml      # Member profile
│   ├── .last-session     # Last activity (UTC)
│   └── .devices          # Registered devices
└── announcements/        # Team announcements

Permission Model

• Based on GitHub repository access
• Can clone repo = can join team
• No additional configuration needed

Configuration

TeamFlow stores configuration in ~/.teamflow/config.yaml:

teams:
  - name: myteam
    path: /path/to/teamflow-myteam
    type: team
  - name: me-username
    path: /path/to/teamflow-me-username
    type: personal

Development

# Clone the repo
git clone https://github.com/anthropics/teamflow.git
cd teamflow

# Install dependencies
bun install

# Run tests
bun test

# Run CLI locally
bun run src/index.ts --help

License

MIT License - see LICENSE for details.

Contributing

Contributions welcome! Please read our contributing guidelines before submitting PRs.