⚡ DevCheats

CLI open-source para salvar, buscar e reutilizar snippets de código direto do terminal.

Sem conta, sem nuvem, sem dependência. Seus snippets ficam num SQLite local e você acha tudo em segundos.

✨ Por que usar?

• Salve aquele comando que você vive googlando
• Busque por título, código, linguagem ou tag
• Copie para o clipboard com 1 comando
• Exporte tudo para Markdown (backup / blog / docs)
• 100% local, rápido e open-source

🚀 Instalação

Pré-requisito: Python 3.9+

# 1. Clone
git clone https://github.com/helvinho/devcheats.git
cd devcheats

# 2. Crie o ambiente dentro do projeto
python3 -m venv .venv
source .venv/bin/activate

# 3. Instale
pip install -e .

# 4. Teste
devcheats --help

Com uv (alternativa rápida):

uv venv
uv pip install -e .
uv run devcheats --help

💡 Uso

# Adicionar (código inline)
devcheats add "serve http" -l bash -t "python,web" -c "python3 -m http.server 8000"

# Adicionar de um arquivo
devcheats add "meu script" -l python -t "utils" -f ./script.py

# Adicionar via pipe / stdin
echo "docker system prune -af" | devcheats add "docker limpa tudo" -l bash -t docker

# Listar tudo
devcheats list

# Filtrar
devcheats list -l python
devcheats list --tag docker

# Buscar
devcheats search docker

# Ver código completo
devcheats show 1

# Copiar para clipboard (tenta pbcopy / wl-copy / xclip / xsel automaticamente)
devcheats copy 1

# Exportar para Markdown
devcheats export -o meus-snippets.md
devcheats export   # imprime no terminal

Exemplo real

$ devcheats add "git desfaz último commit" -l bash -t "git" -c "git reset --soft HEAD~1"
✓ Snippet #1 salvo!

$ devcheats search git
#1 git desfaz último commit [bash] #git

$ devcheats show 1
git desfaz último commit [bash]
tags: git
----------------------------------------
git reset --soft HEAD~1

📁 Onde fica o banco?

Padrão: ~/.local/share/devcheats/snippets.db (respeita $XDG_DATA_HOME).

Para usar outro banco (ex: testes):

devcheats --db /tmp/meu.db list

🧪 Testes

Sem dependências externas, só stdlib:

source .venv/bin/activate
python -m unittest discover -s tests -v

🤝 Contribuindo

PRs são bem-vindos! Veja CONTRIBUTING.md.

Ideias boas para primeiro PR:

• devcheats edit <id> para editar título/tags
• devcheats stats (linguagens mais usadas)
• import de gist / VSCode snippets
• cores configuráveis / --no-color

📝 Licença

MIT — veja LICENSE. Pode usar, forkar e mandar PR à vontade.