Your AI that actually knows you.
Ally is a personal AI system built on Claude Code. It connects to your email, calendar, Slack, and messaging, learns your voice, tracks your relationships, and keeps you focused on what you said matters most.
One install. Modular. Gets better the more you use it.
Communicate — Triage your inbox across every channel. Get draft responses in your voice. Every correction teaches it something new.
Prepare — Morning briefings, meeting prep, market signals. Walk into every meeting with full context, without doing the prep yourself.
Remember — Contact files that build themselves. Staleness alerts when important relationships go quiet. You never forget to follow up.
Focus — Your goals are the filter. Every triage decision, meeting recommendation, and task priority runs through what you said matters. Ally pushes back when your time drifts.
# 1. Clone
git clone https://github.com/djahlor/ally.git
cd ally
# 2. Install (interactive setup, ~2 minutes)
chmod +x install.sh
./install.sh
# 3. Try it
claude
# Then type: /gmYou'll need Claude Code CLI installed, plus Gmail and Google Calendar MCP servers at minimum.
Modular by design. Your core config stays lean. Domain-specific config lives in separate files, auto-loaded via @import.
~/.claude/
├── CLAUDE.md <- Core config (~130 lines)
├── voice/
│ └── style.md <- Your writing voice + examples
├── systems/
│ ├── triage.md <- Inbox triage rules
│ ├── responsibilities.md <- Always-on behaviors
│ ├── mcp-routing.md <- MCP servers + routing
│ ├── confidentiality.md <- Sensitive topic rules
│ └── team-os.md <- Team shared folder (optional)
├── commands/
│ ├── gm.md <- Morning briefing
│ ├── triage.md <- Inbox triage
│ ├── my-tasks.md <- Task management
│ ├── enrich.md <- Contact enrichment
│ └── week-plan.md <- Weekly planning
├── agents/ <- Parallel sub-agents
├── contacts/ <- Personal CRM
├── goals.yaml <- Your objectives
├── my-tasks.yaml <- Task tracking
└── decisions.yaml <- Decision log
Edit any file independently. Add new modules without touching the core.
| Command | What it does |
|---|---|
/gm |
Morning briefing. 7 agents run in parallel: calendar, tasks, inbox, momentum, relationships, research, podcasts. |
/triage |
Scan all connected channels. Classify by urgency. Draft responses in your voice. Learn from every edit. |
/my-tasks |
Tasks with execution, not just tracking. Ally drafts the email, does the research, preps the document. |
/enrich |
Scan channels for relationship updates. Flag stale contacts. Suggest touchpoints. |
/week-plan |
Deep weekly planning. Goals, tasks, calendar, relationships, market signals. |
Every interaction makes the system better:
- Voice learning — Edit a draft, the before/after gets logged. Future drafts incorporate the pattern.
- Acceptance tracking — Tracks how often drafts go through unchanged, by channel and contact.
- Decision memory — Prevents re-debating settled questions. Flags when conditions change.
- Relationship context — Every interaction enriches contact files automatically.
The longer you use it, the better it gets.
The #1 quality lever is voice/style.md. Paste 3-5 real emails you've sent. The examples matter more than any description you could write.
After that:
- Set goals in
goals.yaml - Define your Tier 1 people in
systems/triage.md - Connect MCP servers in
systems/mcp-routing.md - Add contacts to
contacts/
More servers = more capability. Start with the essentials, add over time.
| Server | Required? | What It Enables |
|---|---|---|
| Gmail | Yes | Email triage, drafting, sending |
| Google Calendar | Yes | Scheduling, availability, meeting prep |
| Slack | Recommended | Slack triage, channel monitoring |
| WhatsApp (Beeper) | Optional | WhatsApp message triage |
| Granola | Optional | Meeting notes context |
| Notion | Optional | Docs, knowledge base |
| Exa | Optional | Web search, research |
If your team shares a Google Drive folder, the installer can connect it:
- Shared goals, tasks, and decisions
- Async inbox between teammates
- Two-layer architecture: personal + company tasks
- Write-protected governance
Enter your shared folder path during ./install.sh.
- Push, don't just serve. Ally challenges priorities, says "no" to low-leverage work, and keeps you honest.
- Clarity over comprehensiveness. Fewer priorities. Explicit tradeoffs. Fast decisions.
- Systems compound. Every correction makes it smarter. Every interaction enriches context.
- Ship, don't polish. Drafts should be send-ready. Bias toward closing loops.
- Files over databases. Markdown and YAML. Readable, portable, no lock-in. Your data stays yours.
- Contributing Guide — How to submit changes
- Code of Conduct — Be decent
- Security Policy — Reporting vulnerabilities
- Changelog — What's new
- Architecture — How it works under the hood
- Setup Guide — Full installation walkthrough
- Customization — Make it yours
- Examples — Output samples for every command
Found a bug? Open an issue.
Built by Djahlor Andrews.
MIT License. See LICENSE for details.