Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 11 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,18 +5,18 @@

Found a bug or have feedback? [Open an issue](https://github.com/PostHog/code/issues/new) on GitHub.

# PostHog Code
# πŸ¦” PostHog Code

This is the monorepo for PostHog Code apps and the agent framework that powers them.

## Development
## πŸ› οΈ Development

### Prerequisites
### πŸ“‹ Prerequisites

- Node.js 22+
- pnpm 10.23.0

### Setup
### βš™οΈ Setup

```bash
# Install pnpm if you haven't already
Expand All @@ -32,7 +32,7 @@ cp .env.example .env

```

### Running in Development
### πŸš€ Running in Development

By default, `pnpm dev` uses [mprocs](https://github.com/pvolok/mprocs) to run the agent and code app in parallel.

Expand All @@ -45,7 +45,7 @@ pnpm dev:agent # Run agent in watch mode
pnpm dev:code # Run code app
```

### phrocs (alpha)
### πŸ§ͺ phrocs (alpha)

phrocs is our custom process runner built as a replacement for mprocs. It's currently in alpha and can be used as an alternative dev runner. phrocs does not auto-update β€” you must manually run the update command to pull the latest version.

Expand All @@ -61,7 +61,7 @@ phrocs reads the same `mprocs.yaml` config file. The binary is downloaded to `bi

> **Want to connect to a local PostHog instance?** See [docs/LOCAL-DEVELOPMENT.md](./docs/LOCAL-DEVELOPMENT.md) for OAuth setup and connecting to localhost:8010.

### Utility Scripts
### πŸ”§ Utility Scripts

Scripts in `scripts/` for development and debugging:

Expand All @@ -70,7 +70,7 @@ Scripts in `scripts/` for development and debugging:
| `scripts/clean-posthog-code-macos.sh` | Remove all PostHog Code app data from macOS (caches, preferences, logs, saved state). Use `--app` flag to also delete PostHog Code.app from /Applications. |
| `scripts/test-access-token.js` | Validate a PostHog OAuth access token by testing API endpoints. Usage: `node scripts/test-access-token.js <token> <project_id> [region]` |

## Project Structure
## πŸ“ Project Structure

```
posthog-code/
Expand All @@ -85,7 +85,7 @@ posthog-code/
β”‚ └── shared/ # Shared utilities (Saga pattern, etc.)
```

## Documentation
## πŸ“š Documentation

| File | Description |
|------|-------------|
Expand All @@ -99,10 +99,10 @@ posthog-code/
| [docs/UPDATES.md](./docs/UPDATES.md) | Release versioning and git tagging |
| [docs/TROUBLESHOOTING.md](./docs/TROUBLESHOOTING.md) | Common issues and fixes |

## Contributing
## 🀝 Contributing

We love contributions big and small. See [CONTRIBUTING.md](./CONTRIBUTING.md) to get started.

## Troubleshooting
## πŸ” Troubleshooting

See [docs/TROUBLESHOOTING.md](./docs/TROUBLESHOOTING.md) for common issues (black screen, Electron install failures, native module crashes, etc.).
Loading