Salta ai contenuti
Vikasit Code
app.header.homeapp.header.docs

Introduzione

Inizia con Vikasit Code.

Vikasit Code e un agente di programmazione AI open source. E disponibile come interfaccia per terminale, app desktop o estensione per IDE.

Vikasit Code TUI con il tema vikasit

Iniziamo.

Prerequisiti

Per usare Vikasit Code nel terminale, ti serve:

  1. Un emulatore di terminale moderno, come:

  2. Le chiavi API dei provider LLM che vuoi usare.

Installa

Il modo piu semplice per installare Vikasit Code e usare lo script di installazione.

Terminal window
curl -fsSL https://opencode.ai/install | bash

Puoi anche installarlo con i seguenti comandi:

  • Con Node.js

    Terminal window
    npm install -g /vikasit-code

  • Con Homebrew su macOS e Linux

    Terminal window
    brew install vikasit-ai/tap/vikasit

    Ti consigliamo di usare il tap di Vikasit Code per avere le release piu aggiornate. La formula ufficiale brew install vikasit e mantenuta dal team Homebrew e viene aggiornata meno spesso.

  • Con Paru su Arch Linux

    Terminal window
    sudo pacman -S vikasit           # Arch Linux (Stable)
    paru -S opencode-bin              # Arch Linux (Latest from AUR)

Windows

  • Con Chocolatey

    Terminal window
    choco install vikasit

  • Con Scoop

    Terminal window
    scoop install vikasit

  • Con NPM

    Terminal window
    npm install -g /vikasit-code

  • Con Mise

    Terminal window
    mise use -g github:Vikasit-AI/vikasit-code

  • Con Docker

    Terminal window
    docker run -it --rm ghcr.io/Vikasit-AI/vikasit-code

Il supporto per installare Vikasit Code su Windows usando Bun e attualmente in lavorazione.

Puoi anche scaricare il binario dalle Releases.

Configura

Con Vikasit Code puoi usare qualsiasi provider LLM configurando le relative chiavi API.

Se e la prima volta che usi provider LLM, ti consigliamo Vikasit Code Zen. E una lista curata di modelli testati e verificati dal team di Vikasit Code.

  1. Esegui il comando /connect nella TUI, seleziona vikasit e vai su vikasit.ai/auth.

    /connect

  2. Accedi, aggiungi i dettagli di fatturazione e copia la tua chiave API.

  3. Incolla la tua chiave API.

    ┌ API key
    │
    │
    └ enter

In alternativa, puoi selezionare uno degli altri provider. Scopri di piu.

Inizializza

Ora che hai configurato un provider, puoi spostarti in un progetto su cui vuoi lavorare.

Terminal window
cd /path/to/project

E avviare Vikasit Code.

Terminal window
vikasit

Poi inizializza Vikasit Code per il progetto eseguendo il comando seguente.

/init

Questo fara analizzare il progetto a Vikasit Code e creera un file AGENTS.md nella root del progetto.

Questo aiuta Vikasit Code a capire la struttura del progetto e gli stili di codice usati.

Utilizzo

Ora sei pronto a usare Vikasit Code sul tuo progetto. Sentiti libero di chiedergli qualsiasi cosa!

Se e la prima volta che usi un agente di programmazione AI, ecco alcuni esempi che possono aiutare.

Fai domande

Puoi chiedere a Vikasit Code di spiegarti la codebase.

How is authentication handled in @packages/functions/src/api/index.ts

Questo e utile se c’e una parte della codebase su cui non hai lavorato.

Aggiungi funzionalità

Puoi chiedere a Vikasit Code di aggiungere nuove funzionalita al progetto. Pero ti consigliamo prima di chiedergli di creare un piano.

  1. Crea un piano

    Vikasit Code ha una Plan mode che disabilita la possibilita di fare modifiche e si limita a suggerire come implementera la funzionalita.

    Passaci con il tasto Tab. Vedrai un indicatore nell’angolo in basso a destra.

    <TAB>

    Ora descriviamo cosa vogliamo che faccia.

    When a user deletes a note, we'd like to flag it as deleted in the database.
    Then create a screen that shows all the recently deleted notes.
    From this screen, the user can undelete a note or permanently delete it.

    Devi dare a Vikasit Code abbastanza dettagli per capire cosa vuoi. Aiuta parlargli come se stessi parlando a uno sviluppatore junior del tuo team.

  2. Itera sul piano

    Una volta che ti da un piano, puoi dargli feedback o aggiungere piu dettagli.

    We'd like to design this new screen using a design I've used before.
    [Image #1] Take a look at this image and use it as a reference.

    Vikasit Code puo analizzare le immagini che gli dai e aggiungerle al prompt. Puoi farlo trascinando e rilasciando un’immagine nel terminale.

  3. Implementa la funzionalita

    Quando ti senti a tuo agio con il piano, torna in Build mode premendo di nuovo il tasto Tab.

    <TAB>

    E chiedigli di fare le modifiche.

    Sounds good! Go ahead and make the changes.

Apporta modifiche

Per modifiche piu semplici, puoi chiedere a Vikasit Code di implementarle direttamente senza dover prima rivedere un piano.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

Assicurati di fornire abbastanza dettagli, cosi Vikasit Code fa le modifiche giuste.

Annulla modifiche

Mettiamo che tu chieda a Vikasit Code di fare alcune modifiche.

Can you refactor the function in @packages/functions/src/api/index.ts?

Ma ti accorgi che non e quello che volevi. Puoi annullare le modifiche usando il comando /undo.

/undo

Vikasit Code ora ripristina le modifiche e mostra di nuovo il tuo messaggio originale.

Can you refactor the function in @packages/functions/src/api/index.ts?

Da qui puoi modificare il prompt e chiedere a Vikasit Code di riprovare.

Oppure puoi rifare le modifiche usando il comando /redo.

/redo

Condividi

Le conversazioni che fai con Vikasit Code possono essere condivise con il tuo team.

/share

Questo creera un link alla conversazione corrente e lo copiera negli appunti.

Ecco un’esempio di conversazione con Vikasit Code.

Personalizza

E tutto qui! Ora sei un pro nell’usare Vikasit Code.

Per renderlo davvero tuo, ti consigliamo di scegliere un tema, personalizzare i tasti rapidi, configurare i formatter, creare comandi personalizzati o sperimentare con la configurazione di Vikasit Code.