Kaneo — Gerenciamento de Projetos Minimalista Auto-Hospedado

Introdução

"As melhores ferramentas são invisíveis — elas amplificam seu fluxo de trabalho natural em vez de forçá-lo a se adaptar a elas."

Este é o 172º artigo da série "Um Projeto de Código Aberto por Dia". O projeto de hoje é Kaneo.

Você já usou o Jira? Quem já usou provavelmente se lembra disso: antes de criar um único ticket, você precisa configurar um tipo de projeto, um esquema de fluxo de trabalho, um esquema de permissões, um esquema de notificações — começar pode consumir uma tarde inteira.

Kaneo é uma reação direta a essa experiência. Seu princípio de design se resume em uma linha: "Tudo o que você precisa. Nada do que você não precisa."

Quadro Kanban, visualização em lista, integração com GitHub, um servidor MCP embutido, implantação Docker com um comando — recursos que realmente importam, sem botões desnecessários. 8,9k Estrelas, licença MIT, totalmente auto-hospedado, seus dados permanecem seus.

O Que Você Vai Aprender

Pilha tecnológica do Kaneo: Hono + React + PostgreSQL
Como o servidor MCP embutido permite que Claude, Cursor e outras ferramentas de IA gerenciem tarefas de projeto diretamente
Como funcionam as integrações com GitHub e Gitea
O modelo de dados por trás do design de visualização dupla: Quadro e Lista
Quatro caminhos de implantação: drim CLI, Docker Compose, Coolify e Kubernetes Helm

Pré-requisitos

Familiaridade com o conceito de fluxo de trabalho Kanban
Uso básico do Docker
Opcional: conhecimento básico do MCP (Modelo de Protocolo de Contexto)

Contexto do Projeto

O Que É

Kaneo (pronunciado /kəˈneɪ.oʊ/) é uma ferramenta de gerenciamento de projetos minimalista e auto-hospedada.

Seu posicionamento é claro: não é uma substituição do Jira recurso por recurso, mas uma rebelião filosófica contra o que o Jira representa.

O Jira representa a filosofia de design de "empacotar todos os requisitos concebíveis na ferramenta". O Kaneo representa "incluir apenas o que as equipes realmente precisam." Da descrição oficial: ""

"Kaneo foi construído como uma reação a plataformas de gerenciamento de projetos inchadas e complicadas. Cada botão desnecessário, cada fluxo de trabalho complexo, cada recurso que existe para impressionar em demonstrações em vez de resolver problemas reais — tudo isso desvia a atenção da sua equipe de construir."

Em termos de recursos, o Kaneo oferece: quadros kanban, visualizações em lista, gerenciamento de backlog, atribuição de tarefas e prioridades, etiquetas, comentários, rastreamento de tempo, automação de fluxo de trabalho, gerenciamento de membros da equipe e uma API pública.

O que ele omite deliberadamente: esquemas de permissões complexos, hierarquias de tipos de problemas personalizadas e aplicativos de mercado de terceiros.

Autor / Equipe

Manutenção principal: andrejsshell (equipe Kaneo)
Origem: O fundador Andrej descreve a ferramenta ideal como "invisível" — uma que amplifica os fluxos de trabalho naturais da equipe em vez de impor novos
Website: kaneo.app
Nuvem: cloud.kaneo.app
Comunidade: Discord

Estatísticas do Projeto

⭐ Estrelas no GitHub: 8.900+
🍴 Forks: 746
📄 Licença: MIT
💻 Linguagem Principal: TypeScript (React + Hono)
🌐 Website: kaneo.app
📦 Imagem: ghcr.io/usekaneo/kaneo:latest

Recursos Principais

Que Problema Ele Resolve

Kaneo fornece um fluxo de trabalho completo de gerenciamento de projetos desde o planejamento até a execução:

Workspace
    ↓
Project
    ↓
┌──────────────────┬──────────────────┐
│  Visualização do Quadro │   Visualização em Lista │
│  Kanban arrastar-soltar │   Filtrar & ordenar   │
└──────────────────┴──────────────────┘
    ↓ Fonte de dados única compartilhada
      (status, prioridades, etiquetas permanecem sincronizados)
Tarefa
    ├── Proprietário + data de vencimento
    ├── Prioridade (P0–P3)
    ├── Etiquetas (personalizadas)
    ├── Comentários + rastreamento de tempo
    └── Relações de tarefas (dependências, etc.)

Cenários de Uso

Substituição para pequenas equipes do Jira
- Sem necessidade dos esquemas de permissões e fluxos de trabalho personalizados do Jira — apenas kanban e gerenciamento de tarefas. Kaneo vai de zero a utilizável em minutos, não em dias.
Gerenciamento de tarefas assistido por IA
- Com o servidor MCP embutido, crie, consulte e atualize tarefas a partir de uma conversa com Claude ou Cursor — sem necessidade de abrir um navegador.
Soberania de dados auto-hospedada
- Implantação Docker, dados armazenados em sua própria instância PostgreSQL, sem serviços de terceiros necessários.
Sincronização do GitHub para equipes de desenvolvimento
- Veja o status das Issues do GitHub diretamente no Kaneo; gerencie o planejamento de produtos e o desenvolvimento de código a partir de uma única visualização.
Integrações de notificações
- Suporta Discord, Slack, Telegram, email, ntfy, Gotify e webhooks — conecte qualquer canal de notificação que sua equipe utilize.

Início Rápido

Caminho mais simples (drim CLI):

curl -fsSL https://assets.kaneo.app/install.sh | sh
drim setup

Cuida automaticamente de HTTPS, configuração de banco de dados e inicialização de serviços. Melhor para implantações em servidores.

Docker Compose (local ou pequena produção):

# docker-compose.yml
services:
  postgres:
    image: postgres:16
    environment:
      POSTGRES_DB: kaneo
      POSTGRES_USER: kaneo
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - "5432:5432"

  kaneo:
    image: ghcr.io/usekaneo/kaneo:latest
    environment:
      DATABASE_URL: postgresql://kaneo:${POSTGRES_PASSWORD}@postgres:5432/kaneo
      AUTH_SECRET: ${AUTH_SECRET}
      KANEO_CLIENT_URL: http://localhost:5173
    ports:
      - "5173:5173"
    depends_on:
      - postgres

# Gerar AUTH_SECRET
openssl rand -hex 32

# Iniciar
docker compose up -d