docs: redesign README with landing page content and images

- Add centered header with logo (dark/light mode), badges, and nav links
- Use landing page headline "Your next 10 hires won't be human."
- Add hero banner illustration and product screenshot from landing page
- Feature sections with inline images (teammates, runtimes)
- Rewrite feature descriptions to match landing page messaging
- Add architecture table alongside diagram
- Create logo SVGs in docs/assets/
- All links verified against main branch (CLI_AND_DAEMON.md, CONTRIBUTING.md, etc.)
This commit is contained in:
Jiayuan 2026-04-02 00:46:02 +08:00
parent 05fcf35ab9
commit 479d69305d
7 changed files with 101 additions and 35 deletions

120
README.md
View file

@ -1,28 +1,84 @@
# Multica
<div align="center">
AI-native project management — like Linear, but with AI agents as first-class team members.
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
<img alt="Multica" src="docs/assets/logo-light.svg" width="220">
</picture>
Multica lets you manage tasks and collaborate with AI agents the same way you work with human teammates. Agents can be assigned issues, post comments, update statuses, and execute work autonomously on your local machine.
<br />
## Features
**Your next 10 hires won't be human.**
- **AI agents as teammates** — assign issues to agents, mention them in comments, and let them do the work
- **Local agent runtime** — agents run on your machine using Claude Code or Codex, with full access to your codebase
- **Real-time collaboration** — WebSocket-powered live updates across the board
- **Multi-workspace** — organize work across teams with workspace-level isolation
- **Familiar UX** — if you've used Linear, you'll feel right at home
AI-native project management — assign tasks, track progress, and collaborate across human-agent teams.
[![CI](https://github.com/multica-ai/multica/actions/workflows/ci.yml/badge.svg)](https://github.com/multica-ai/multica/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![GitHub stars](https://img.shields.io/github/stars/multica-ai/multica?style=flat)](https://github.com/multica-ai/multica/stargazers)
[Website](https://multica.ai) · [Cloud](https://app.multica.ai) · [Self-Hosting](SELF_HOSTING.md) · [Contributing](CONTRIBUTING.md)
</div>
<br />
<p align="center">
<img src="docs/assets/banner.jpg" alt="Multica — humans and agents, side by side" width="800">
</p>
<br />
<p align="center">
<img src="docs/assets/hero-screenshot.png" alt="Multica board view" width="800">
</p>
## What is Multica?
Multica is a project management platform where **AI agents are first-class team members**. Assign issues to agents, @mention them in comments, and they'll write code, report progress, and update statuses — just like a human teammate.
Think Linear, but your AI agents sit right next to you on the board. Supports **Claude Code** and **Codex**.
---
<img align="right" src="docs/assets/feature-teammates.jpg" width="380">
### Agents as Teammates
Agents aren't tools you invoke — they're teammates you collaborate with. They have profiles, show up on the board, post comments, create issues, and report blockers.
One unified activity feed for your entire team, human and AI alike.
<br clear="right"/>
---
<img align="right" src="docs/assets/feature-runtimes.jpg" width="380">
### Local & Cloud Runtimes
Agents run on your machine via a local daemon, or scale to cloud infrastructure. The daemon auto-detects Claude Code and Codex on your PATH, spins up isolated environments, and streams real-time progress via WebSocket.
Full control over where your code runs.
<br clear="right"/>
---
### Reusable Skills
Write a skill once, and every agent on your team can use it. Deployments, migrations, code reviews — skills compound your team's capabilities exponentially.
### Multi-Workspace
Organize work across teams with workspace-level isolation. Each workspace has its own agents, issues, and settings.
## Getting Started
### Use Multica Cloud
### Multica Cloud
The fastest way to get started: [multica.ai](https://multica.ai)
The fastest way to get started — no setup required: **[multica.ai](https://multica.ai)**
### Self-Host
Run Multica on your own infrastructure. See the [Self-Hosting Guide](SELF_HOSTING.md) for full instructions.
Quick start with Docker:
### Self-Host with Docker
```bash
git clone https://github.com/multica-ai/multica.git
@ -30,14 +86,13 @@ cd multica
cp .env.example .env
# Edit .env — at minimum, change JWT_SECRET
# Start PostgreSQL
docker compose up -d
# Build and run the backend
cd server && go run ./cmd/migrate up && cd ..
make start
docker compose up -d # Start PostgreSQL
cd server && go run ./cmd/migrate up && cd .. # Run migrations
make start # Start the app
```
See the [Self-Hosting Guide](SELF_HOSTING.md) for full instructions.
## CLI
The `multica` CLI connects your local machine to Multica — authenticate, manage workspaces, and run the agent daemon.
@ -70,23 +125,18 @@ See the [CLI and Daemon Guide](CLI_AND_DAEMON.md) for the full command reference
└──────────────┘
```
- **Frontend**: Next.js 16 (App Router)
- **Backend**: Go (Chi router, sqlc, gorilla/websocket)
- **Database**: PostgreSQL 17 with pgvector
- **Agent Runtime**: Local daemon executing Claude Code or Codex
| Layer | Stack |
|-------|-------|
| Frontend | Next.js 16 (App Router) |
| Backend | Go (Chi router, sqlc, gorilla/websocket) |
| Database | PostgreSQL 17 with pgvector |
| Agent Runtime | Local daemon executing Claude Code or Codex |
## Development
For contributors working on the Multica codebase, see the [Contributing Guide](CONTRIBUTING.md).
### Prerequisites
- [Node.js](https://nodejs.org/) (v20+)
- [pnpm](https://pnpm.io/) (v10.28+)
- [Go](https://go.dev/) (v1.26+)
- [Docker](https://www.docker.com/)
### Quick Start
**Prerequisites:** [Node.js](https://nodejs.org/) v20+, [pnpm](https://pnpm.io/) v10.28+, [Go](https://go.dev/) v1.26+, [Docker](https://www.docker.com/)
```bash
pnpm install
@ -99,4 +149,4 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow, worktr
## License
See [LICENSE](LICENSE) for details.
[Apache 2.0](LICENSE)