Salta ai contenuti

Installazione

Questa guida installa codeknit dal sorgente, lo aggiunge al PATH, abilita i completamenti della shell e verifica che funzioni.

Prerequisiti

  • Go 1.26 o successivo
  • Un compilatore C. codeknit utilizza CGo per costruire i suoi parser tree-sitter.

Passaggi

Finestra del terminale
git clone https://github.com/awslabs/codeknit.git
cd codeknit
make build

Il binario viene scritto in ./bin/codeknit.

I binari precompilati per Linux, macOS e Windows (amd64 e arm64) sono disponibili nella pagina delle release. Scarica l’archivio per la tua piattaforma, estrailo e sposta il binario nel tuo PATH. Ogni release include un file checksums.txt con cui puoi verificare il download.

Salta questa sezione se hai spostato il binario in una directory già presente nel PATH, come /usr/local/bin.

Sostituisci /path/to/codeknit con la directory che contiene il binario. Se hai compilato dal sorgente, questa è la directory bin all’interno del repository clonato.

Aggiungi la riga per la tua shell al suo file di configurazione:

Finestra del terminale
# bash (~/.bashrc)
export PATH="$PATH:/path/to/codeknit"
# zsh (~/.zshrc)
export PATH="$PATH:/path/to/codeknit"
# fish (~/.config/fish/config.fish)
fish_add_path /path/to/codeknit

Ricarica la shell o esegui il source del file che hai modificato:

Finestra del terminale
source ~/.bashrc # bash
source ~/.zshrc # zsh

Per fish, apri un nuovo terminale.

codeknit genera script di completamento per bash, zsh, fish e PowerShell. Esegui il comando per la tua shell una volta:

Finestra del terminale
# bash
codeknit completion bash >> ~/.bashrc
# zsh
codeknit completion zsh >> ~/.zshrc
# fish
codeknit completion fish > ~/.config/fish/completions/codeknit.fish
# PowerShell
codeknit completion powershell >> $PROFILE

I comandi per bash, zsh e PowerShell aggiungono il contenuto al tuo profilo. Eseguendoli nuovamente, lo script viene aggiunto una seconda volta, quindi esegui ciascun comando solo una volta.

Apri una nuova shell o esegui il source del tuo profilo per attivare i completamenti.

Finestra del terminale
codeknit --version

Se il comando stampa una versione, codeknit è installato. Se la shell riporta command not found, verifica che la directory nella riga del PATH contenga il binario codeknit, quindi ricarica la shell.

Fai questo solo se hai intenzione di contribuire a codeknit. Esegui questi comandi dalla radice del repository clonato:

Finestra del terminale
make deps # installa le dipendenze
make setup # configura i git hooks
make test # esegui la test suite

make lint esegue il linter e il formatter.