open-index/open-npm huggingface dataset:
npm package: @guidemode/cli
Description: Command line interface for GuideMode
Latest version: 0.1.46

# @guidemode/cli

> **Command-line interface for GuideMode.**

A simple CLI for authenticating with GuideMode and managing sessions from your terminal.

## Installation

```bash
npm install -g @guidemode/cli
```

## Usage

### Authentication

```bash
# Login to GuideMode
guidemode login

# Check who you're logged in as
guidemode whoami

# Logout
guidemode logout
```

That's it! The CLI shares authentication with the desktop app, so you only need to login once.

## What It Does

- **Login**: Opens browser for GitHub OAuth authentication
- **Session Info**: Check your authentication status
- **Logout**: Clear stored credentials

Perfect for CI/CD pipelines, scripts, or terminal-focused workflows.

## Configuration

Shares config with desktop app: `~/.guidemode/config.json`

```json
{
  "apiKey": "your-api-key",
  "serverUrl": "https://app.guidemode.dev",
  "username": "your-username"
}
```

## For Developers

### Build from Source

```bash
git clone https://github.com/guidemode/cli.git
cd cli
pnpm install
pnpm build
```

**See [CLAUDE.md](CLAUDE.md) for:**
- Development setup
- Architecture details
- Adding new commands

### Tech Stack

- Commander.js for CLI parsing
- Dual build (ESM + CommonJS)
- TypeScript with full type safety

## Related Packages

- [@guidemode/desktop](https://github.com/guidemode/desktop) - Desktop app
- [@guidemode/types](https://github.com/guidemode/types) - Shared types

## License

MIT License - see [LICENSE](LICENSE)

## Support

- 💬 [**Discussions**](https://github.com/orgs/guidemode/discussions) - Ask questions, share ideas
- 🐛 [**Issues**](https://github.com/guidemode/desktop/issues) - Report bugs, request features
- 📧 **Email**: support@guidemode.dev
npm package: @guidemode/session-processing
Description: Shared session processing, metrics calculation, AI processing, and UI components for GuideMode
Latest version: 0.2.7

# @guidemode/session-processing

> **The analytics engine that powers GuideMode.**

Parses AI coding sessions from any provider and generates actionable insights. One parser for all AI tools.

## Why This Matters

**Before:** Each AI tool had different formats → 5+ custom parsers → maintenance nightmare

**Now:** Unified canonical format → 1 parser → consistent analytics for all providers

## Installation

```bash
npm install @guidemode/session-processing
```

## Usage

### Parse Any Provider

```typescript
import { ParserRegistry } from '@guidemode/session-processing/parsers'

const registry = new ParserRegistry()
const parser = registry.getParser('claude-code') // or gemini, copilot, codex, opencode

const parsed = parser.parse(sessionContent)
// Works the same for all providers!
```

### Calculate Metrics

```typescript
import { CanonicalSessionProcessor } from '@guidemode/session-processing/processors'

const processor = new CanonicalSessionProcessor()
const metrics = await processor.processMetrics(sessionContent, context)

// Get: performance, usage, quality, engagement, error metrics
```

## Key Features

- ✅ **One Parser** - Handles all AI providers (Claude, Gemini, Copilot, Codex, OpenCode)
- ✅ **Canonical Format** - Universal message structure
- ✅ **Rich Metrics** - Performance, usage, quality, engagement, errors, context
- ✅ **Provider Metadata** - Preserves provider-specific features
- ✅ **UI Components** - React components for session display

## Supported Providers

All via the same unified parser:
- **Claude Code** - Anthropic
- **Gemini Code** - Google
- **GitHub Copilot** - GitHub
- **Codex** - AI assistant
- **OpenCode** - Open source

## For Developers

### Build from Source

```bash
git clone https://github.com/guidemode/session-processing.git
cd session-processing
pnpm install
pnpm build
```

**See [CLAUDE.md](CLAUDE.md) for:**
- Parser architecture details
- How canonical format works
- Adding new providers
- Metrics processor documentation

### Tech Stack

- TypeScript with strict type safety
- Unified canonical parser
- 6 metric processors
- React UI components
- Dual build (ESM + CommonJS)

## What Gets Analyzed

- **Performance** - Response times, token usage
- **Usage** - Commands executed, files modified, tools used
- **Quality** - Success rates, error handling
- **Engagement** - User interactions, turn counts
- **Errors** - Error detection and categorization
- **Context** - Context window usage, file tracking

## Related Packages

- [@guidemode/desktop](https://github.com/guidemode/desktop) - Converts provider formats to canonical
- [@guidemode/types](https://github.com/guidemode/types) - Shared type definitions

## License

MIT License - see [LICENSE](LICENSE)

## Support

- 💬 [**Discussions**](https://github.com/orgs/guidemode/discussions) - Ask questions, share ideas
- 🐛 [**Issues**](https://github.com/guidemode/desktop/issues) - Report bugs, request features
- 📧 **Email**: support@guidemode.dev
npm package: @guidemode/types
Description: Shared TypeScript types for GuideMode
Latest version: 0.2.7

# @guidemode/types

> **Shared TypeScript types for the GuideMode ecosystem.**

Type definitions used across all GuideMode packages for type safety and consistency.

## Installation

```bash
npm install @guidemode/types
```

## Usage

```typescript
import type { AgentSession, SessionMetrics } from '@guidemode/types'

const session: AgentSession = {
  sessionId: 'session-123',
  provider: 'claude-code',
  startTime: new Date(),
  // ...
}
```

## What's Included

- **Session Types** - AgentSession, ParsedMessage, SessionPhase
- **Metrics Types** - Performance, Usage, Quality, Engagement, Error metrics
- **API Types** - Request/response shapes for all endpoints
- **Database Types** - Schema types matching database models
- **Auth Types** - OAuth, sessions, permissions
- **Canonical Format Types** - Universal message format for all providers

## Key Features

- ✅ **Dual Module Support** - ESM and CommonJS
- ✅ **Full Type Safety** - Strict TypeScript compilation
- ✅ **Canonical Format** - Unified types for all AI providers
- ✅ **Runtime Validation** - Zod schemas for provider data

## For Developers

### Build from Source

```bash
git clone https://github.com/guidemode/types.git
cd types
pnpm install
pnpm build
```

**See [CLAUDE.md](CLAUDE.md) for:**
- Complete type catalog
- Semantic organization structure
- How to add new types

## Related Packages

- [@guidemode/desktop](https://github.com/guidemode/desktop) - Desktop app
- [@guidemode/session-processing](https://github.com/guidemode/session-processing) - Analytics engine
- [@guidemode/cli](https://github.com/guidemode/cli) - CLI tool

## License

MIT License - see [LICENSE](LICENSE)

## Support

- 💬 [**Discussions**](https://github.com/orgs/guidemode/discussions) - Ask questions, share ideas
- 🐛 [**Issues**](https://github.com/guidemode/desktop/issues) - Report bugs, request features
- 📧 **Email**: support@guidemode.dev