O que choomfie faz?
Agente de IA pessoal alimentado pelo Claude Code CLI — Discord + Terminal + Memória + Habilidades
Visão Geral
O choomfie é um agente de IA pessoal que combina várias capacidades em uma única ferramenta:
- Integração com Discord: Interaja com o agente através de mensagens no Discord
- Acesso ao Terminal: Execute comandos Unix diretamente através do agente
- Memória Persistente: Mantenha contexto e lembre-se de interações passadas
- Sistema de Habilidades: Estenda as capacidades do agente com novas funcionalidades
Como Funciona
O choomfie é executado como um processo no terminal e se conecta ao Discord como um bot. Você pode enviar comandos para ele através de mensagens diretas no Discord, e ele responderá executando ações no terminal ou usando suas habilidades.
Exemplo de Uso
# Iniciar o agente
./choomfie start
# Enviar um comando via Discord
!executar ls -la
# Consultar memória
!lembrar "qual era o diretório do projeto X?"
Instalação
- Clone o repositório
- Configure as variáveis de ambiente necessárias
- Execute o script de instalação
git clone https://github.com/ANonABento/choomfie.git
cd choomfie
./setup.sh
Configuração
Crie um arquivo .env com as seguintes variáveis:
DISCORD_TOKEN=seu_token_do_discord
CLAUDE_API_KEY=sua_chave_api_claude
SKILL_DIR=./skills
Habilidades
O choomfie suporta um sistema de habilidades personalizadas. Cada habilidade é um diretório dentro da pasta skills/ que contém um arquivo SKILL.md descrevendo suas capacidades.
Estrutura de uma Habilidade
skills/
minha-habilidade/
SKILL.md
index.ts (opcional)
Comandos
!executar <comando>- Executa um comando no terminal!lembrar <consulta>- Consulta a memória do agente!esquecer- Limpa o histórico de memória!ajuda- Mostra esta mensagem de ajuda
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.
Licença
Este projeto está licenciado sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.