Instalação
Instale o lightyear com um comando, sem sudo, e mantenha ele atualizado.
Um comando (Linux e macOS)
curl -fsSL https://nvizble.github.io/Lightyear42/install.sh | sh
Sem curl (comum em VMs Debian recém-instaladas), use o wget:
wget -qO- https://tinyurl.com/lightyear42 | sh
Funciona nas máquinas da 42: não pede sudo nem depende do Go instalado. Depois, abra um terminal novo e rode lightyear version.
O que o instalador faz
- Descobre o sistema (Linux ou macOS) e o processador (x86_64 ou arm64).
- Baixa o release correspondente do GitHub Releases.
- Confere o sha256 do download com o
checksums.txtdo release. - Instala o binário em
~/.local/bin/lightyear. - Se essa pasta não estiver no
PATH, adiciona uma linha (marcada com# lightyear) no rc do seu shell:~/.bashrc,~/.zshrc,~/.config/fish/config.fishou~/.profile.
Opções
Passe as opções depois de sh -s --:
| Opção | O que faz |
|---|---|
--canary |
instala a canary mais nova (pre-release) |
--version 1.2.1 |
instala uma versão específica |
--dir ~/bin |
instala em outra pasta (padrão: ~/.local/bin) |
curl -fsSL https://nvizble.github.io/Lightyear42/install.sh | sh -s -- --canary
wget -qO- https://tinyurl.com/lightyear42 | sh -s -- --version 1.2.1
A pasta também pode vir da variável LIGHTYEAR_DIR.
Ubuntu / Debian (.deb)
Se você tem sudo, o pacote .deb instala em /usr/bin:
VER=1.2.0 # ajuste para a versão desejada
curl -sLO "https://github.com/nvizble/Lightyear42/releases/download/v${VER}/lightyear_${VER}_linux_amd64.deb"
sudo apt install "./lightyear_${VER}_linux_amd64.deb"
lightyear version
Em ARM64, troque linux_amd64.deb por linux_arm64.deb.
macOS ou Linux, manualmente
Baixe o .tar.gz do seu sistema no GitHub Releases e coloque o binário numa pasta do PATH:
VER=1.2.0
curl -sL "https://github.com/nvizble/Lightyear42/releases/download/v${VER}/lightyear_${VER}_Darwin_arm64.tar.gz" \
| tar -xz lightyear
mkdir -p ~/.local/bin && mv lightyear ~/.local/bin/
lightyear version
Os nomes dos arquivos seguem o padrão lightyear_<versão>_<SO>_<arch>.tar.gz: Darwin_arm64 (Apple Silicon), Darwin_x86_64 (Mac Intel), Linux_x86_64 e Linux_arm64.
Windows
Baixe o lightyear_<versão>_Windows_x86_64.zip no GitHub Releases, extraia o lightyear.exe e coloque numa pasta do PATH.
Atenção: o
lightyear testprecisa de Linux ou macOS (usafork). No Windows, use o WSL para rodar os testes de projeto.
Via Go
go install github.com/nvizble/Lightyear42/cmd/lightyear@latest
Exige Go 1.25+ e um compilador C (cc, gcc ou clang): o realce de sintaxe do editor usa Tree-sitter, que é C. O binário vai para $(go env GOPATH)/bin (no Windows, %USERPROFILE%\go\bin), que precisa estar no PATH.
Atenção: o Go das máquinas da 42 costuma ser mais antigo (1.23). Lá, prefira o instalador de um comando: ele não depende do Go.
Atualizar
Quando sai uma versão nova do seu canal, o lightyear avisa no fim dos comandos:
✦ Nova versão do lightyear disponível: 1.3.0-canary.35 → 1.3.0-canary.36
Atualize com: lightyear update
No app em tela cheia, o aviso aparece na barra de abas. O lightyear confere no máximo uma vez por dia, em segundo plano, sem atrasar o comando e sem usar a API do GitHub. O aviso fica de fora de scripts e pipes, em CI e nos comandos update e version. Para desligar: export LIGHTYEAR_NO_UPDATE_NOTIFIER=1.
lightyear update --check # só verifica se há versão nova
lightyear update # baixa e substitui o binário atual
lightyear update -y # sem pedir confirmação
O update também não usa Go. Ele precisa de permissão de escrita na pasta do binário: em ~/.local/bin, tudo certo; numa instalação via .deb (em /usr/bin), use sudo ou instale o .deb novo pelo apt.
Builds sem versão de release (compiladas localmente, versão dev) só atualizam com --force.
Canais: estável e canary
| Comando | O que faz |
|---|---|
lightyear update --canary |
entra no canal canary: pre-releases v1.3.0-canary.N, com as novidades antes |
lightyear update --stable |
volta para o canal estável (instala a última estável, mesmo que seja mais antiga que a canary instalada) |
Quem está numa canary continua recebendo canaries no lightyear update, até voltar com --stable. Para ver o que mudou na versão instalada, rode lightyear --version; o histórico completo está em lightyear version --changelog.
Desinstalar
-
Saia da conta, para remover o token do keyring do sistema:
lightyear logout -
Apague o binário (o caminho aparece em
command -v lightyear):rm "$(command -v lightyear)"Se instalou pelo
.deb, usesudo apt remove lightyear. -
Se quiser, apague também os dados locais. O
lightyear config showmostra os caminhos usados na sua máquina; os padrões são:Caminho Conteúdo ~/.config/42cli/config.yaml(credenciais OAuth, ntfy, amigos, tema do editor)~/.local/share/42cli/PDFs e índice de subjects, estado das notificações, sessão do simulador ~/.cache/42cli/cache das respostas da API; no Linux, também o clangd e o ty baixados pelo editor ~/Library/Caches/42cli/só no macOS: o ty baixado pelo editor ~/lightyear-exam/suas soluções do simulador de provas As variáveis
XDG_CONFIG_HOME,XDG_DATA_HOMEeXDG_CACHE_HOMEmudam a pasta base das três primeiras, se estiverem definidas. -
Remova a linha
# lightyearque o instalador pôs no rc do seu shell, se houver.