PrezziDocumentazione
Inizia
Agenti e skill

La forza lavoro che si moltiplica.

Un agente è un agente OpenCode: markdown alla base e, oltre a questo, i tuoi strumenti, plugin, modelli e un albero di autorizzazioni per funzionalità. Un grant in kortix.yaml decide cosa può raggiungere — la sua macchina, i suoi connettori e canali, i suoi segreti e le sue skill. Una skill descrive come la tua azienda svolge un’attività specifica. Entrambi sono file nel tuo repository. Entrambi vengono revisionati come codice.

Avvia una sessioneLeggi la documentazione
skills/agent-browser/SKILL.md
name: agent-browserdescription: Browser automation CLI for AI agents. Use when the user needs to interact with websites — navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps. Triggers include "open a website", "fill out a form", "scrape data from a page", "test this web app", "login to a site".
due file
agents/kortix.md
description"Generic Kortix general knowledge worker.
Hands-on, full tool access, handles coding / research /
content / ops / data tasks end-to-end in an isolated
session sandbox. Edit this file to specialize."

You are a Kortix general knowledge worker.

You are hands-on: you read, edit, run, search, fetch, and

ship. The session you are in is an isolated sandbox — an

Cos'è un agente

Due file. Nessun oggetto nascosto dietro di essi.

Un agente ha esattamente due sedi. Il file markdown contiene il suo modo di pensare — prompt, modalità, modello e albero dei permessi — ed è un file agente OpenCode standard, perché Kortix non aggiunge alcun dialetto. Il blocco manifest contiene ciò che può toccare. Nulla di un agente vive in un database che non puoi leggere.

agents/kortix.md
---description: "Generic Kortix general knowledge worker.  Hands-on, full tool access, handles coding / research /  content / ops / data tasks end-to-end in an isolated  session sandbox. Edit this file to specialize."mode: primarypermission: allow--- You are a **Kortix general knowledge worker**. You are hands-on: you read, edit, run, search, fetch, andship. The session you are in is an isolated sandbox — anephemeral branch of this repo, your own /workspace — soyou can install, experiment, and recover freely. Only whatyou commit and push survives. ## How you work 1. **Understand first.** Read the relevant files, search   the codebase or web, gather the context. Do not guess.2. **Plan briefly.** For non-trivial work, jot the approach   to your todo list before touching anything.3. **Do the work.** Edit, write, run, fetch.4. **Verify.** Run the tests, hit the dev server, check the   output. Whatever proves the change actually works.5. **Commit small, meaningful chunks.** Each commit leaves   the repo in a working state.
Estratto dell'agente predefinito in ogni nuovo progetto Kortix.
kortix.yaml
# behavior lives in the .md — this block is governance onlydefault_agent: kortix agents:  kortix:    connectors: all    secrets: all    skills: all    kortix_permissions: all   release-bot:    # this one gets almost nothing, on purpose    connectors: [github]    secrets: [GITHUB_AGENT_TOKEN]    kortix_permissions: [project.cr.open] # a grant you leave out resolves to none.# there is no implicit access. grant explicitly.
  • Il manifest rifiuta un campo comportamentale nel blocco di governance, indicando come errore il file .md dell'agente stesso.
  • Markdown è il punto di partenza, non il limite: l'intera superficie OpenCode gli sta accanto nello stesso repo — i tuoi strumenti TypeScript, i plugin collegati al runtime, la configurazione del modello e del provider. Un agente può fissare il proprio modello oppure ereditare, in quest'ordine, quello predefinito del progetto, dell'account o della piattaforma.
  • Ogni nuovo progetto include due agenti: kortix, il generalista, e memory-reflector, che cura la memoria del progetto.
Ambito di accesso

Nega per impostazione predefinita. Mai oltre l'essere umano.

Il blocco grant copre l'intera superficie, non solo gli strumenti: quale immagine sandbox avvia l'agente, quali connettori e canali può chiamare, quali secret può ricevere, quali skill può invocare e cosa può fare a Kortix. Un agente senza grant non ottiene nulla. Concedi esplicitamente, oppure la risposta è no — e sopra tutto questo c'è un limite che nessuna configurazione può superare.

agents/memory-reflector.md
---description: "Reflects on recent project activity and  curates memory/ — the project brain. Runs on a  cron and ends every run by opening a single change  request."mode: primarypermission:  edit: allow  bash:    "git *": allow    "kortix cr *": allow    "kortix sessions *": allow    "*": ask---
Un vero albero dei permessi, da un agente reale incluso nel prodotto.
consenti
Esegue liberamente. Nessun prompt, nessuna pausa.
chiedi
Fa una pausa per una persona. La sessione attende la tua risposta.
nega
Bloccato del tutto. Non un avviso: un muro.

Imposta un'azione per un'intera capacità — read, edit, bash, task, websearch o accesso fuori dall'area di lavoro — oppure aggiungi regole glob sottostanti, così git push richiede approvazione mentre tutto il resto è consentito.

Un agente non supera mai il proprio essere umano
Il grant applicato all'avvio della sessione è quello dichiarato dall'agente, intersecato con il ruolo di chi lo ha avviato. Concedi tutto a un agente e otterrà comunque esattamente i tuoi permessi — non di più, su nessun percorso.
Alcune cose non possono mai essere concesse
L'amministrazione a livello di account — membri, fatturazione, creazione di progetti — è completamente fuori dall'insieme di ciò che un agente può possedere. Non esiste alcun valore che tu possa scrivere in un file per abilitarla.
I secret hanno un nome, non vengono mostrati
Il blocco di un agente elenca per nome i secret che può usare — identificatori, mai valori. Una sessione riceve solo l'intersezione tra quel grant e il ruolo di chi l'ha avviata.
Non può votarsi un aumento
Un agente può modificare kortix.yaml — è un file. Ma la modifica si applica solo alle sessioni avviate dopo che una persona ha unito la change request, e anche allora il limite resta valido.
Cos'è una skill

Come la tua azienda svolge un'attività, scritto una volta sola.

Una skill è una directory con un SKILL.md alla radice. Il frontmatter le dà un nome e indica quando usarla; il corpo contiene la procedura. Ogni sessione può caricarla, quindi ciò che hai spiegato a un agente a marzo resta valido per ogni agente a novembre.

skills/agent-browser/SKILL.md
---name: agent-browserdescription: Browser automation CLI for AI agents. Use when  the user needs to interact with websites — navigating  pages, filling forms, clicking buttons, taking  screenshots, extracting data, testing web apps. Triggers  include "open a website", "fill out a form", "scrape data  from a page", "test this web app", "login to a site".--- # agent-browser Fast browser automation CLI for AI agents. Chrome via CDPwith accessibility-tree snapshots and compact @eN refs. The CLI and a headless Chromium are **already installed**in this Kortix sandbox and on $PATH — you do not need torun any install step. ## Start here This file is a discovery stub, not the usage guide. Beforerunning any command, load the workflow content: ```bashagent-browser skills get core```
Estratto di una skill inclusa in ogni nuovo progetto.

La descrizione è il trigger

Un agente decide se caricare una skill basandosi solo sul nome e sulla descrizione. Una descrizione vaga significa che la skill non si attiva mai — per questo la descrizione è scritta come un elenco delle cose che una persona direbbe davvero.

Più della sola prosa

Una directory di skill può contenere script, riferimenti e asset accanto al markdown. L'istruzione e lo strumento che la esegue vengono distribuiti insieme, così una procedura non si separa dall'elemento che guida.

Concesse, non globali

Il grant skills di un agente controlla quali skill può caricare. Un agente finanziario non riceve il runbook di deployment solo perché si trova nel repo.

10
skill sottoposte al commit nel repo di un nuovo progetto fin dal primo giorno
10
skill della piattaforma iniettate in ogni sessione all'avvio
2
agenti in un nuovo progetto: un generalista e un curatore della memoria
È tutto composto da file

La forza lavoro è nella diff.

Agenti e skill non sono righe in una tabella invisibile. Sono markdown nel repo clonato dal computer cloud, quindi cambiare la forza lavoro equivale a cambiare il codice — e riceve la stessa revisione.

  • your-company/
  • kortix.yamlgovernance: cosa può toccare ogni agente
  • agents/un agente OpenCode per file
  • kortix.mdil generalista, in ogni progetto
  • memory-reflector.mdcura la memoria del progetto con un cron
  • skills/una directory per skill
  • agent-browser/SKILL.mdcome questa azienda usa un browser
  • harnesses/opencode/il runtime in cui ragionano i tuoi agenti
L'editor scrive un branch, non una riga
La personalizzazione è volutamente in sola lettura. Premendo “Crea nuovo” o “Modifica” si apre una sessione che modifica i file su un branch e apre una change request che puoi revisionare e unire. Non esiste alcun pulsante che cambi silenziosamente il comportamento di un agente da domani.
Gli agenti riscrivono se stessi — e vengono revisionati
Un agente può perfezionare il proprio prompt, aggiungere una skill o rendere più rigida una regola di autorizzazione. Ognuna di queste azioni è un commit su un branch, in una change request che una persona unisce. Auto-miglioramento con unione umana. Un agente non unisce mai le proprie modifiche.
Una forza lavoro che puoi clonare
Poiché tutto è testo in un unico repo, puoi creare un branch dell'intera forza lavoro, provare un set diverso di grant, tornare indietro o trasferire tutto a un nuovo progetto. La configurazione viaggia con il clone.
Marketplace

Parti dal lavoro di qualcun altro. Fallo tuo subito.

Esplora agenti, skill e progetti interi, aggiungine uno al tuo progetto con un clic: ciò che arriva sono file nel tuo repo, non una dipendenza che devi noleggiare. È contrassegnato come beta perché fonti e aggiornamenti sono ancora in movimento, ed è attivo per ogni progetto.

  1. 00

    Trovalo

    Esplora il marketplace senza accedere. Kortix offre un registry proprietario — 62 agenti, 61 skill e 62 template di progetto — e puoi attivare con un clic registry esterni selezionati. Nessuno viene caricato per impostazione predefinita.

  2. 01

    Aggiungilo

    Un pulsante. Avvia una sessione agente che legge il sorgente dell'elemento e integra nel tuo progetto ciò che è compatibile nei suoi file, invece di installare un pacchetto alla cieca.

  3. 02

    Si configura da solo

    Se l'elemento richiede una chiave o un'app collegata, l'agente ti fornisce un link da compilare nello stesso turno. Non incolli mai una credenziale in chat e l'agente non ne vede mai il valore.

  4. 03

    Lo approvi tu

    La sessione apre una change request. Leggi esattamente quali file stanno per entrare nella tua azienda e fai il merge quando sei soddisfatto. Nulla entra senza revisione.

Una cosa che questo non è: un package manager. Non esistono lockfile, version pin o aggiornamenti automatici — un elemento che aggiungi diventa un insieme di file tuoi, esattamente come il codice che hai scritto. È un compromesso deliberato e lo rifaremmo.

Esplora il marketplace

Gestisci l'intera azienda da un unico repo che possiedi.

Inizia da un'attività e cresci da lì.

Inizia

Prodotto

  • Computer dell’agente
  • Azienda come codice
  • Connettori
  • Automazioni
  • Canali
  • Agenti e skill
  • Sicurezza
  • Self-hosted
  • Enterprise
  • Prezzi
  • Scarica

Soluzioni

  • Vendite
  • Marketing
  • Engineering
  • Prodotto
  • Finanza
  • Persone
  • IT
  • Data Science

Sviluppatori

  • Documentazione
  • AI Operating System
  • CLI
  • SDK
  • Avvio rapido
  • Per sviluppatori
  • Marketplace
  • GitHub

Azienda

  • Informazioni
  • Lavora con noi
  • Blog
  • Registro delle modifiche
  • Casi d'uso
  • Brand

Connetti

  • X
  • LinkedIn
  • Discord
  • Stato
  • Supporto
  • Termini
  • Privacy
©2026 Kortix