# Basecamp


> Everything you and your team know, in one place. Basecamp is a scheduler that
> runs Claude Code tasks on a timer — syncing data, extracting entities,
> drafting emails, preparing for meetings. No server, no database — just plain
> files, markdown, and Claude. Your knowledge base is Obsidian-compatible, your
> config is JSON, and everything is transparent.

### What you get

- Automatic email and calendar sync from Apple Mail and Calendar
- A knowledge graph of people, organizations, projects, and topics
- AI-drafted email responses that use your full context
- Meeting preparation briefings before every call
- Presentation generation from markdown to PDF
- File organization and cleanup on autopilot
- A macOS status menu showing what's running

---

### Who it's for

**Busy engineers and managers** who want an AI assistant that actually knows
their context — who they work with, what projects are active, and what's coming
up next.

**Anyone on macOS** who wants a set-and-forget knowledge system that runs
quietly in the background and keeps getting smarter about your work.

---

## Built-in Skills

| Skill                    | What it does                                   |
| ------------------------ | ---------------------------------------------- |
| **Sync Apple Mail**      | Reads email threads from Mail.app via SQLite   |
| **Sync Apple Calendar**  | Reads upcoming events from Calendar.app        |
| **Extract Entities**     | Processes synced data into a knowledge graph   |
| **Draft Emails**         | Writes response drafts using your full context |
| **Meeting Prep**         | Creates briefings before upcoming meetings     |
| **Create Presentations** | Generates PDF slide decks from markdown        |
| **Document Collab**      | Assists with document creation and editing     |
| **Organize Files**       | Cleans up and organizes your files             |

---

## Prerequisites

Basecamp spawns `claude` as a subprocess without loading your shell profile.
Install Claude Code via **Homebrew** (`brew install claude`) rather than the
native binary — the Homebrew install runs on Node.js, which supports
`NODE_EXTRA_CA_CERTS` for enterprise CA certificates.

If your network requires a custom CA bundle, add an `env` block to
`~/.fit/basecamp/scheduler.json`:

```json
{
  "env": {
    "NODE_EXTRA_CA_CERTS": "~/.config/ssl/ca-bundle.pem"
  }
}
```

---

## Quick Start

```sh
npx fit-basecamp --init ~/Documents/Team   # Initialize knowledge base
npx fit-basecamp --daemon                   # Start the scheduler
npx fit-basecamp --status                   # Check what's happening
npx fit-basecamp --run sync-mail            # Run a task now
```

### macOS Privacy & Security

Basecamp agents need access to specific folders (Documents, Mail, Calendar).
When macOS prompts, grant only the folders each process needs via **System
Settings → Privacy & Security → Files & Folders**:

- **Basecamp.app** — the TCC responsible process (Swift launcher)
- **node** — runs skill scripts with `#!/usr/bin/env node` shebangs
- **"2.1.72"** (or another version number) — this is the **Claude Code CLI**.
  macOS shows its version string instead of a name. Safe to grant per-folder
  access.