solobuddy

# SoloBuddy

Build-in-public content assistant. A living companion, not a tool.

## Quick Start

1. Set your data path in `~/.clawdbot/clawdbot.json`:
```json
{
  "solobuddy": {
    "dataPath": "~/projects/my-bip-folder",
    "voice": "jester-sage"
  }
}
```

2. Create folder structure (replace path with your own):
```bash
mkdir -p ~/projects/my-bip-folder/ideas ~/projects/my-bip-folder/drafts ~/projects/my-bip-folder/data
touch ~/projects/my-bip-folder/ideas/backlog.md
```

3. Start using: "show backlog", "new idea", "generate post"

## Placeholders

ClawdBot automatically replaces these in commands:
- `{dataPath}` → your configured `solobuddy.dataPath`
- `{baseDir}` → skill installation folder

## Data Structure

All data in `{dataPath}`:
- `ideas/backlog.md` — idea queue
- `ideas/session-log.md` — session captures
- `drafts/` — work in progress
- `data/my-posts.json` — published posts
- `data/activity-snapshot.json` — project activity (updated hourly)

## Voice Profiles

Configure in `solobuddy.voice`. Available:

| Voice | Description |
|-------|-------------|
| `jester-sage` | Ironic, raw, philosophical (default) |
| `technical` | Precise, detailed, structured |
| `casual` | Friendly, conversational |
| `custom` | Use `{dataPath}/voice.md` |

See `{baseDir}/prompts/profile.md` for voice details.

## Modules

### Content Generation
Core workflow: backlog → draft → publish.
See `{baseDir}/prompts/content.md` for rules.

### Twitter Expert
Content strategy for X/Twitter with 2025 algorithm insights.
See `{baseDir}/modules/twitter-expert.md`

### Twitter Monitor (optional)
Proactive engagement — monitors watchlist, suggests comments.
Requires: `bird` CLI. See `{baseDir}/modules/twitter-monitor.md`

### Soul Wizard
Create project personality from documentation.
See `{baseDir}/references/soul-wizard.md`

## Commands

### Backlog

Show ideas:
```bash
cat {dataPath}/ideas/backlog.md
```

Add idea:
```bash
echo "- [ ] New idea text" >> {dataPath}/ideas/backlog.md
```

#...

# SoloBuddy

> Build-in-public companion for indie hackers

A living assistant, not a tool. SoloBuddy helps you maintain a consistent build-in-public presence without the cognitive overhead.

## What It Does

- **Content Workflow**: Idea backlog → Draft → Publish
- **Twitter Expert**: 2025 algorithm insights, hook formulas, engagement optimization
- **Twitter Monitor**: Proactive engagement opportunities from your watchlist
- **Soul Wizard**: Create project personalities from documentation
- **Activity Tracking**: Know which projects need attention

## Install

```bash
npx clawdhub@latest install solobuddy
```

## Quick Setup

1. Configure in `~/.clawdbot/clawdbot.json`:

```json
{
  "solobuddy": {
    "dataPath": "~/projects/my-build-in-public",
    "voice": "jester-sage"
  }
}
```

2. Create folder structure (use the same path as in config):

```bash
mkdir -p ~/projects/my-build-in-public/ideas ~/projects/my-build-in-public/drafts ~/projects/my-build-in-public/data
touch ~/projects/my-build-in-public/ideas/backlog.md
```

3. Start chatting: "show backlog", "new idea", "generate post"

## Voice Profiles

| Voice | Style |
|-------|-------|
| `jester-sage` | Ironic, raw, philosophical (default) |
| `technical` | Precise, detailed, structured |
| `casual` | Friendly, conversational |
| `custom` | Your own `voice.md` file |

## Modules

### Core
- Backlog management
- Draft creation
- Publishing flow
- Session logging

### Twitter Expert
Content strategy with:
- 5 proven hook formulas
- 2025 algorithm insights
- Quality checklist
- Anti-pattern detection

### Twitter Monitor (optional)
Requires `bird` CLI:
- Watchlist monitoring
- Engagement opportunities
- Draft comments with reasoning

### Soul Wizard
Interactive creation of project personalities:
- Nature (creature/tool/guide/artist)
- Voice attributes
- Philosophy extraction
- Dreams & pains

## Telegram Integration

Full button support for mobile workflow:
- Quick navigation
- One-tap generation
- Draft managemen...