Autohand Konfigurációs referencia

June 23, 2026 · View on GitHub

Teljes referencia az összes konfigurációs beállításhoz itt: ~/.autohand/config.json (vagy .toml/.yaml/.yml).

Tipp: A legtöbb alábbi beállítás interaktívan módosítható a /settings paranccsal a fájl manuális szerkesztése helyett.

Lokalizált referenciák:

Tartalomjegyzék

A konfigurációs fájl helye
Környezeti változók
Csupasz mód
Szolgáltatói beállítások
Munkaterület beállításai
UI beállítások
Ügynökbeállítások
Engedélyek beállításai
Javítási mód
Hálózati beállítások
Telemetriai beállítások
Külső ügynökök
Skills System
API beállítások
Authentication Settings
Közösségi készségek beállításai
Megosztási beállítások
Beállítások szinkronizálása
Hook beállításai
MCP beállítások
Chrome-bővítmény beállításai
Teljes példa

Konfigurációs fájl helye

Autohand a következő sorrendben keresi a konfigurációt:

AUTOHAND_CONFIG környezeti változó (egyéni elérési út)
~/.autohand/config.toml
~/.autohand/config.yaml
~/.autohand/config.yml
~/.autohand/config.json (alapértelmezett)

Az alapkönyvtárat is felülírhatja:

export AUTOHAND_HOME=/custom/path  # Changes ~/.autohand to /custom/path

Környezeti változók

Változó	Leírás	Példa
`AUTOHAND_HOME`	Alapkönyvtár az összes Autohand adathoz	`/custom/path`
`AUTOHAND_CONFIG`	Egyéni konfigurációs fájl elérési útja	`/path/to/config.toml`
`AUTOHAND_API_URL`	API-végpont (felülbírálja a konfigurációt)	`https://api.autohand.ai`
`AUTOHAND_SECRET`	Vállalat/csapat titkos kulcsa	`sk-xxx`
`AUTOHAND_PERMISSION_CALLBACK_URL`	Az engedély visszahívásának URL-je (kísérleti)	`http://localhost:3000/callback`
`AUTOHAND_PERMISSION_CALLBACK_TIMEOUT`	Az engedély-visszahívás időtúllépése ms-ban	`5000`
`AUTOHAND_NON_INTERACTIVE`	Futtatás nem interaktív módban	`1`
`AUTOHAND_YES`	Minden felszólítás automatikus megerősítése	`1`
`AUTOHAND_NO_BANNER`	Indítási szalaghirdetés letiltása	`1`
`AUTOHAND_STREAM_TOOL_OUTPUT`	Az eszköz kimenetének streamelése valós időben	`1`
`AUTOHAND_DEBUG`	Hibakeresési naplózás engedélyezése	`1`
`AUTOHAND_THINKING_LEVEL`	Érvelési mélységszint beállítása	`normal`
`AUTOHAND_CLIENT_NAME`	Kliens/szerkesztő azonosító (ACP kiterjesztések által beállítva)	`zed`
`AUTOHAND_CLIENT_VERSION`	Kliens verzió (az ACP-bővítmények által beállított)	`0.169.0`
`AUTOHAND_CODE`	Környezetérzékelési jelző (automatikusan beállítva)	`1`
`AUTOHAND_CODE_SIMPLE`	A csupasz mód engedélyezése a `--bare`	átadása nélkül `1`

Gondolkodási szint

A AUTOHAND_THINKING_LEVEL környezeti változó szabályozza a modell által használt érvelés mélységét:

Érték	Leírás
`none`	Közvetlen válaszok látható indoklás nélkül
`normal`	Szabványos érvelési mélység (alapértelmezett)
`extended`	Mély érvelés összetett feladatokhoz, részletesebb gondolkodási folyamatot mutat

Ezt általában az ACP-kliens-bővítmények (például a Zed) állítják be a konfigurációs legördülő menüben.

# Example: Use extended thinking for complex tasks
AUTOHAND_THINKING_LEVEL=extended autohand --prompt "refactor this module"

Csupasz mód

A csupasz mód a Autohand csak kifejezetten kért kontextus- és futásidejű integrációkkal indul. Engedélyezze a következők egyikével:

autohand --bare
AUTOHAND_CODE_SIMPLE=1 autohand

A --bare átadásakor a Autohand a AUTOHAND_CODE_SIMPLE=1 értéket is beállítja a futó folyamathoz.

A csupasz mód letiltja az automatikus indítást és az interaktív integrációkat:

horgok és horog értesítések
LSP indítás
plugin szinkronizálás, bővítmény automatikus betöltése és meta-eszköz automatikus betöltése
hozzárendelés, telemetria, munkamenet-szinkronizálás, automatikus jelentéskészítés és háttérpingek
automatikus memória/munkamenet bootstrap kontextus
háttérkérdések, frissítés-ellenőrzések, funkciójelző-lekérések és modell-metaadatok előzetes letöltése
kulcstartó és böngésző OAuth-hitelesítési tartalék
automatikus AGENTS.md és szolgáltatói utasítás keresés
minden perjel parancs, beleértve a parancssorba beírt csupasz /

A perjel alakú abszolút fájlútvonalakat, például a /Users/alex/project/file.ts, továbbra is normál prompt szövegként kezeli a rendszer. A parancs alakú perjel bevitel, például /help, /model vagy /mcp, a Slash commands are disabled in bare mode. kódot írja ki, és nem hajtódik végre.

A csupasz módban történő hitelesítés csak explicit. A Autohand először a következőt olvassa: AUTOHAND_API_KEY, majd auth.apiKeyHelper, ha be van állítva. Nem olvassa be a kulcstartó hitelesítő adatait, és nem indítja el az OAuth/böngésző bejelentkezést. A külső szolgáltatók továbbra is a szolgáltatóspecifikus API-kulcsokat és konfigurációkat használják.

Ezek az explicit bemenetek csupasz módban is elérhetők:

Bemenet	Leírás
`--system-prompt <value>`	Cserélje ki a rendszerprompt szövegközi szöveggel vagy elérési út-szerű értékkel
`--system-prompt-file <path>`	Cserélje ki a rendszerpromptot a fájltartalommal
`--append-system-prompt <value>`	Szövegközi szöveg vagy elérési út-szerű érték hozzáfűzése a
`--append-system-prompt-file <path>`	Fájl tartalmának hozzáfűzése a rendszerprompthoz
`--add-dir <path...>`	Explicit könyvtárak hozzáadása a munkaterület hatóköréhez
`--mcp-config <path>`	Töltsön be egy explicit MCP konfigurációs fájlt
`--settings`	Nyissa meg a beállításokat közvetlenül a CLI jelzőből
`--config <path>`	Használjon explicit Autohand konfigurációs fájlt
`--agents <json\|path>`	Explicit beépített ügynökök JSON vagy explicit ügynökök könyvtárának betöltése
`--plugin-dir <path>`	Töltsön be egy explicit plugin/meta-tool könyvtárat

Szolgáltatói beállítások

`provider`

Aktív LLM szolgáltató használható.

Érték	Leírás
`"openrouter"`	OpenRouter API (alapértelmezett)
`"ollama"`	Helyi Ollama példány
`"llamacpp"`	Helyi llama.cpp szerver
`"openai"`	OpenAI API közvetlenül
`"mlx"`	MLX az Apple Siliconon (helyi)
`"llmgateway"`	LLM Gateway egyesített API
`"deepseek"`	DeepSeek API
`"zai"`	Z.ai GLM API
`"sakana"`	Sakana.AI Fugu API
`"bedrock"`	AWS alapkőzet
`"custom:<id>"`	Felhasználó által meghatározott OpenAI-kompatibilis szolgáltató a következőtől: `customProviders`

`openrouter`

OpenRouter szolgáltató konfigurációja.

{
  "openrouter": {
    "apiKey": "sk-or-v1-xxx",
    "baseUrl": "https://openrouter.ai/api/v1",
    "model": "your-modelcard-id-here",
    "contextWindow": 262144
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`apiKey`	húr	Igen	-	Az Ön OpenRouter API kulcsa
`baseUrl`	húr	Nem	`https://openrouter.ai/api/v1`	API-végpont
`model`	húr	Igen	-	Modellazonosító (pl. `your-modelcard-id-here`)
`contextWindow`	szám	Nem	Auto	Pontos modell kontextusablak. Autohand kitölti ezt az OpenRouterből, ha ismert.

`zai`

Z.ai szolgáltató konfigurációja.

{
  "zai": {
    "apiKey": "your-zai-api-key",
    "baseUrl": "https://api.z.ai/api/paas/v4",
    "model": "glm-5.2",
    "contextWindow": 1000000
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`apiKey`	húr	Igen	-	Az Ön Z.ai API-kulcsa
`baseUrl`	húr	Nem	`https://api.z.ai/api/paas/v4`	API-végpont
`model`	húr	Igen	`glm-5.2`	Modellazonosító, például `glm-5.2`, `glm-5.1` vagy `glm-4.5`
`contextWindow`	szám	Nem	Auto	Pontos modell kontextusablak. A Autohand 1M-re következtet a GLM-5.2-nél és 200K-ra a GLM-5.1-nél.

`sakana`

Sakana.AI szolgáltató konfigurációja. Az API OpenAI-kompatibilis, és a https://api.sakana.ai/v1-t használja alap URL-ként.

{
  "sakana": {
    "apiKey": "your-sakana-api-key",
    "baseUrl": "https://api.sakana.ai/v1",
    "model": "fugu",
    "contextWindow": 1000000
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`apiKey`	húr	Igen	-	Az Ön Sakana API kulcsa
`baseUrl`	húr	Nem	`https://api.sakana.ai/v1`	API-végpont
`model`	húr	Igen	`fugu`	Modellazonosító, például `fugu` vagy `fugu-ultra`
`contextWindow`	szám	Nem	Auto	Pontos modell kontextusablak. Autohand 1M-re következtet a Fugu modelleknél.

`customProviders`

Az egyéni szolgáltatók lehetővé teszik a felhasználók számára, hogy OpenAI-kompatibilis végpontot hozzanak létre kódmódosítás vagy új csomagolt szolgáltató nélkül. Adja hozzá a szolgáltatót a customProviders alatt, majd válassza ki a provider: "custom:<id>" kóddal. Ugyanez a folyamat elérhető a /model Új szolgáltatóval. A telepítés során a Autohand a szolgáltató mentése előtt ellenőrzi az alap URL-t, a hitelesítést és a kiválasztott modellt az OpenAI-kompatibilis /models végponton keresztül.

{
  "provider": "custom:acme",
  "customProviders": {
    "acme": {
      "id": "acme",
      "displayName": "Acme AI",
      "apiFormat": "openai-compatible",
      "baseUrl": "https://api.acme.example/v1",
      "apiKey": "acme-api-key",
      "apiKeyRequired": true,
      "model": "acme-code-1",
      "contextWindow": 256000,
      "reasoningEffort": "high",
      "models": [
        {
          "id": "acme-code-1",
          "label": "Acme Code 1",
          "contextWindow": 256000,
          "reasoningEffort": "high"
        }
      ]
    }
  }
}

Azon helyi OpenAI-kompatibilis szervereknél, amelyek nem igényelnek hitelesítést, állítsa a apiKeyRequired értékét false értékre, és hagyja ki a apiKey értéket.

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`id`	húr	Igen	-	Stabil szolgáltatói azonosító. Meg kell egyeznie az objektumkulccsal, és a következőképpen van kiválasztva: `custom:<id>`.
`displayName`	húr	Igen	-	A `/model` és a szolgáltató beállításai között látható név.
`apiFormat`	húr	Igen	-	A következőnek kell lennie: `openai-compatible`.
`baseUrl`	húr	Igen	-	Végpont gyökér, például `https://api.example.com/v1`. Autohand ellenőrzi a `/models` kódot, és felhívja a `/chat/completions` kódot.
`apiKey`	húr	Feltételes	-	Adathordozó token a tárolt végpontokhoz. Kötelező, ha a `apiKeyRequired` igaz.
`apiKeyRequired`	logikai	Nem	`true`	Állítsa be a false értéket a helyi vagy már hitelesített átjárókhoz.
`model`	húr	Igen	-	Aktív modell azonosító.
`contextWindow`	szám	Nem	Auto	Pontos kontextusablak a token-költségvetéshez, állapothoz, telemetriához és szinkronizálási metaadatokhoz.
`reasoningEffort`	húr	Nem	-	Opcionális `none`, `low`, `medium`, `high` vagy `xhigh`. `reasoning_effort` néven küldve egyéni OpenAI-kompatibilis kérésekhez.
`models`	tömb	Nem	-	Opcionális modellválasztó bejegyzések modellenkénti kontextussal és érvelési metaadatokkal.

`ollama`

Ollama szolgáltató konfigurációja.

{
  "ollama": {
    "baseUrl": "http://localhost:11434",
    "port": 11434,
    "model": "llama3.2"
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`baseUrl`	húr	Nem	`http://localhost:11434`	Ollama szerver URL
`port`	szám	Nem	`11434`	Szerverport (a baseUrl alternatívája)
`model`	húr	Igen	-	Modellnév (pl. `llama3.2`, `codellama`)

`llamacpp`

llama.cpp szerver konfigurációja.

{
  "llamacpp": {
    "baseUrl": "http://localhost:8080",
    "port": 8080,
    "model": "default"
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`baseUrl`	húr	Nem	`http://localhost:8080`	llama.cpp szerver URL
`port`	szám	Nem	`8080`	Szerver port
`model`	húr	Igen	-	Modellazonosító

`openai`

OpenAI API konfiguráció.

{
  "openai": {
    "authMode": "api-key",
    "apiKey": "sk-xxx",
    "baseUrl": "https://api.openai.com/v1",
    "model": "gpt-5.4"
  }
}

Az OpenAI a Autohand beépített OpenAI bejelentkezési folyamatán keresztül is használhatja ChatGPT-előfizetését:

{
  "openai": {
    "authMode": "chatgpt",
    "baseUrl": "https://api.openai.com/v1",
    "contextWindow": 1050000,
    "model": "gpt-5.4",
    "chatgptAuth": {
      "accessToken": "...",
      "refreshToken": "...",
      "accountId": "..."
    }
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`authMode`	húr	Nem	`api-key`	Hitelesítési mód: `api-key` vagy `chatgpt`
`apiKey`	húr	Igen a `api-key` módhoz	-	OpenAI API kulcs
`baseUrl`	húr	Nem	`https://api.openai.com/v1`	API-végpont
`model`	húr	Igen	-	Modellnév (pl. `gpt-5.4`, `gpt-5.4-mini`)
`contextWindow`	szám	Nem	Auto	Pontos modell kontextusablak. Állítsa be az elavult helyi feltételezések felülbírálásához.
`chatgptAuth`	tárgy	Igen a `chatgpt` módhoz	-	Tárolt ChatGPT/Codex hitelesítési tokenek és fiókazonosító

`mlx`

MLX szolgáltató Apple Silicon Mac gépekhez (helyi következtetés).

{
  "mlx": {
    "baseUrl": "http://localhost:8080",
    "port": 8080,
    "model": "mlx-community/Llama-3.2-3B-Instruct-4bit"
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`baseUrl`	húr	Nem	`http://localhost:8080`	MLX szerver URL
`port`	szám	Nem	`8080`	Szerver port
`model`	húr	Igen	-	MLX modell azonosító

`llmgateway`

LLM Gateway egységes API konfiguráció. Hozzáférést biztosít több LLM-szolgáltatóhoz egyetlen API-n keresztül.

{
  "llmgateway": {
    "apiKey": "your-llmgateway-api-key",
    "baseUrl": "https://api.llmgateway.io/v1",
    "model": "gpt-4o"
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`apiKey`	húr	Igen	-	LLM Gateway API kulcs
`baseUrl`	húr	Nem	`https://api.llmgateway.io/v1`	API-végpont
`model`	húr	Igen	-	Modellnév (pl. `gpt-4o`, `claude-3-5-sonnet-20241022`)

API-kulcs beszerzése: Keresse fel a llmgateway.io/dashboard webhelyet fiók létrehozásához és API-kulcsának beszerzéséhez.

Támogatott modellek: Az LLM Gateway több szolgáltató modelljét támogatja, többek között:

OpenAI: gpt-4o, gpt-4o-mini, gpt-4-turbo claude-3-5-haiku-20241022
Google: gemini-1.5-pro, gemini-1.5-flash

`deepseek`

DeepSeek szolgáltató konfigurációja. Az API OpenAI-kompatibilis, és a https://api.deepseek.com-t használja alap URL-ként.

{
  "deepseek": {
    "apiKey": "your-deepseek-api-key",
    "baseUrl": "https://api.deepseek.com",
    "model": "deepseek-v4-flash"
  }
}

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`apiKey`	húr	Igen	-	DeepSeek API kulcs
`baseUrl`	húr	Nem	`https://api.deepseek.com`	API-végpont
`model`	húr	Igen	-	Modellnév, például `deepseek-v4-flash` vagy `deepseek-v4-pro`

`bedrock`

AWS Bedrock szolgáltató konfigurációja. converse az alapértelmezett mód, és az AWS SDK hitelesítési láncot használja. Az OpenAI-kompatibilis módok Bedrock API-kulcsokat és Bedrock OpenAI-kompatibilis végpontokat használnak.

{
  "bedrock": {
    "apiMode": "converse",
    "authMode": "aws-credentials",
    "profile": "enterprise-prod",
    "region": "us-east-1",
    "model": "anthropic.claude-3-5-sonnet-20241022-v2:0"
  }
}

provider: bedrock
bedrock:
  apiMode: openai-chat
  authMode: bedrock-api-key
  apiKey: bedrock-api-key
  region: us-east-1
  model: openai.gpt-oss-120b-1:0

provider = "bedrock"

[bedrock]
apiMode = "openai-responses"
authMode = "bedrock-api-key"
apiKey = "bedrock-api-key"
region = "us-west-2"
endpoint = "https://vpce-abc123.bedrock-runtime.us-west-2.vpce.amazonaws.com/openai/v1"
model = "arn:aws:bedrock:us-west-2:123456789012:inference-profile/us.anthropic.claude-3-5-sonnet-20241022-v2:0"

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`model`	húr	Igen	-	Alapkőzetmodell-azonosító, következtetési profilazonosító vagy ARN
`region`	húr	Igen	`AWS_REGION`, majd `AWS_DEFAULT_REGION`, majd `us-east-1` a beállításban	AWS régió
`apiMode`	húr	Nem	`converse`	`converse`, `openai-chat` vagy `openai-responses`
`authMode`	húr	Nem	`aws-credentials` `converse`, `bedrock-api-key` OpenAI-kompatibilis módokhoz	Hitelesítési mód
`profile`	húr	Nem	-	Opcionális AWS-profil a hitelesítő adatok láncos hitelesítéséhez
`endpoint`	húr	Nem	Módból és régióból származtatva	Egyéni/privát Bedrock végpont
`apiKey`	húr	Igen OpenAI-kompatibilis módokhoz	-	Bedrock API kulcs. Ne használjon OpenAI API-kulcsokat.

Futtassa a aws configure sso kódot, vagy állítsa be a AWS_PROFILE=enterprise-prod autohand értéket a profilalapú AWS-hitelesítéshez. Az IAM-szerepkört, a tárolót és a példány metaadat-hitelesítő adatait az AWS SDK támogatja. Modell használata előtt engedélyezze a modellelérést az AWS-konzolon.

Munkaterület beállításai

{
  "workspace": {
    "defaultRoot": "/path/to/projects",
    "allowDangerousOps": false
  }
}

Mező	Típus	Alapértelmezett	Leírás
`defaultRoot`	húr	Aktuális címtár	Alapértelmezett munkaterület, ha nincs megadva
`allowDangerousOps`	logikai	`false`	Pusztító műveletek engedélyezése megerősítés nélkül

Munkahelyi biztonság

Autohand automatikusan blokkolja a működést a veszélyes könyvtárakban, hogy megelőzze a véletlen károsodást:

Fájlrendszer gyökerei (/, C:\, D:\ stb.)
Házikönyvtárak (~, /Users/<user>, /home/<user>, C:\Users\<user>)
Rendszerkönyvtárak (/etc, /var, /System, C:\Windows stb.)
WSL Windows-csatlakozások (/mnt/c, /mnt/c/Users/<user>)

Ezt az ellenőrzést nem lehet megkerülni. Ha egy veszélyes könyvtárban próbálja meg futtatni a autohand alkalmazást, hibaüzenetet fog látni, és meg kell adnia egy biztonságos projektkönyvtárat.

# This will be blocked
cd ~ && autohand
# Error: Unsafe Workspace Directory

# This works
cd ~/projects/my-app && autohand

A részletekért lásd a Workspace Safety részt.

UI beállítások

{
  "ui": {
    "theme": "dark",
    "customThemes": {
      "company": {
        "colors": {
          "accent": "#7c3aed",
          "success": "#22c55e"
        }
      }
    },
    "autoConfirm": false,
    "readFileCharLimit": 300,
    "silentToolOutput": false,
    "activityVerbs": ["Compiling", "Parsing", "Reviewing"],
    "activityVerbsEnabled": true,
    "activitySymbol": "✳",
    "statusLine": {
      "showProviderModel": true,
      "showContext": true,
      "showCommandHint": true,
      "showPullRequest": true,
      "showSessionLines": false,
      "showQueue": true,
      "showActiveStatus": true,
      "showActiveMetrics": true,
      "showCancelHint": true
    },
    "showCompletionNotification": true,
    "showThinking": true,
    "terminalBell": true,
    "checkForUpdates": true,
    "updateCheckInterval": 24
  }
}

Mező	Típus	Alapértelmezett	Leírás
`theme`	húr	`"dark"`	Színes téma a terminál kimenetéhez. A beépítettek a következők: `dark`, `light`, `dracula`, `sandy`, `tui`, `github-dark`, `cappadocia`, CODE és _8 `australia`. A régi `turkey` és `brazil` értékek továbbra is betöltődnek álnévként.
`customThemes`	tárgy	`{}`	Soron belüli egyéni témadefiníciók a téma nevével. A használatához állítsa be a `theme` kulcsot ugyanarra a kulcsra.
`autoConfirm`	logikai	`false`	A biztonságos működés érdekében hagyja ki a megerősítő felszólításokat
`readFileCharLimit`	szám	`300`	Maximum megjeleníthető karakter az olvasási/kereső eszköz kimenetéből (a teljes tartalom továbbra is elküldésre kerül a modellnek)
`silentToolOutput`	logikai	`false`	A szerszám kimeneti blokkjainak elrejtése a terminálban, miközben továbbra is megőrzi a modell/munkamenet szerszámeredményeit
`activityVerbs`	karakterlánc vagy karakterlánc[]	beépített medence	Egyéni tevékenység ige vagy igekészlet a munkajelzőhöz, `Verb...` formátumban
`activityVerbsEnabled`	logikai	`true`	Forgó tevékenység igék megjelenítése, például `Compiling...`, miközben az ügynök dolgozik
`activitySymbol`	húr	`"✳"`	A tevékenységi ige előtt látható szimbólum a tevékenységmutató kimenetében
`statusLine.showProviderModel`	logikai	`true`	Jelenítse meg az aktív szolgáltatót és modellt a szerző állapotsorában
`statusLine.showContext`	logikai	`true`	Jelenítse meg a kontextus százalékos arányát a szerző állapotsorában
`statusLine.showCommandHint`	logikai	`true`	Parancs, említés, készség és terminálbejegyzési tippek megjelenítése a szerző állapotsorában
`statusLine.showPullRequest`	logikai	`true`	Mutassa meg a kapcsolódó lekérési kérés számát, vagy `PR #123`, ha nincs PR társítva
`statusLine.showSessionLines`	logikai	`false`	Az aktuális munkamenet során hozzáadott és eltávolított sorok megjelenítése
`statusLine.showQueue`	logikai	`true`	A sorba állított kérések számának megjelenítése az állapotsorban
`statusLine.showActiveStatus`	logikai	`true`	Az aktív forduló állapotszövege megjelenítése, miközben az ügynök dolgozik
`statusLine.showActiveMetrics`	logikai	`true`	Az eltelt idő és a token mérőszámainak megjelenítése, amíg az ügynök dolgozik
`statusLine.showCancelHint`	logikai	`true`	Az Esc megszakítási tipp megjelenítése, miközben az ügynök dolgozik
`completionReportEnabled`	logikai	`true`	Kérje meg a modellt, hogy a végrehajtott műveleti körök után tartalmazzon egy tömör befejezési jelentést
`showCompletionNotification`	logikai	`true`	Rendszerértesítés megjelenítése a feladat befejezésekor
`showThinking`	logikai	`true`	Az LLM érvelésének/gondolati folyamatának megjelenítése
`terminalBell`	logikai	`true`	Csengessen terminálcsengőt, amikor a feladat befejeződött (jelvényt mutat a terminálfülön/dokkon)
`checkForUpdates`	logikai	`true`	CLI frissítések keresése indításkor
`updateCheckInterval`	szám	`24`	Órák a frissítési ellenőrzések között (a gyorsítótárazott eredményt az intervallumon belül használja)

Az egyéni témák bármely szemantikai színtokent felülírhatnak. A hiányzó tokenek a sötét témából származnak:

{
  "ui": {
    "theme": "company",
    "customThemes": {
      "company": {
        "vars": {
          "brand": "#7c3aed",
          "brandSoft": "#a78bfa"
        },
        "colors": {
          "accent": "brand",
          "borderAccent": "brandSoft",
          "mdHeading": "brand"
        }
      }
    }
  }
}

Megjegyzés: A readFileCharLimit és silentToolOutput csak a terminál megjelenítését érinti. A teljes tartalom továbbra is elküldésre kerül a modellnek, és eszközüzenetekben tárolódik.

A néma eszközkimenetet a fájl szerkesztése nélkül is átkapcsolhatja:

autohand config set silent_tool_output true
autohand config set silent_tool_output false

A forgó tevékenység igék között válthat a fájl szerkesztése nélkül:

autohand config set verbs activity true
autohand config set verbs activity false

Szabja testre az igéket a konfigurációs fájlban, ha rögzített állapotcímkét vagy kis projektspecifikus elforgatást szeretne:

{
  "ui": {
    "activityVerbs": "Compiling"
  }
}

{
  "ui": {
    "activityVerbs": ["Indexing", "Reviewing", "Testing"],
    "activitySymbol": ">"
  }
}

A activityVerbs egyetlen karakterláncot vagy nem üres karakterlánc-tömböt fogad el. Ha a activityVerbsEnabled értéke false, a Autohand visszaesik a Working... értékre, ahelyett, hogy az egyéni vagy beépített igék között forogna.

A fájl szerkesztése nélkül válthat a befejezési jelentések között, beleértve a strukturált SITREP promptot is:

autohand config set sitrep true
autohand config set sitrep false

Terminal Bell

Ha a terminalBell engedélyezve van (alapértelmezett), a Autohand megszólal a terminál csengőjén (\x07), amikor egy feladat befejeződik. Ez kiváltja:

Jelvény a terminál lapon - Vizuális jelzőt mutat, hogy a munka elkészült
Dokk ikon ugrál - Felhívja a figyelmet, ha a terminál a háttérben van (macOS)
Hang - Ha a terminál hangjai engedélyezve vannak a terminál beállításaiban

Terminálspecifikus beállítások:

macOS terminál: Beállítások > Profilok > Speciális > Bell (vizuális/hallható)
iTerm2: Beállítások > Profilok > Terminál > Értesítések
VS Code Terminal: Beállítások > Terminál > Integrált: Bell engedélyezése

Letiltása:

{
  "ui": {
    "terminalBell": false
  }
}

Ink Renderer

A Autohand alapértelmezés szerint az Ink 7 + React 19 renderert használja az interaktív terminálokhoz. A régi ui.useInkRenderer konfigurációs mezőt figyelmen kívül hagyja, így a régi konfigurációs fájlok nem kényszeríthetik a sima terminálszerkesztőt. A tinta a következőket nyújtja:

Recgésmentes kimenet: Minden UI-frissítés kötegelt React-egyeztetésen keresztül történik
Munkasor funkció: Írja be az utasításokat, amíg az ügynök dolgozik
Jobb bemenetkezelés: Nincsenek ütközések a readline-kezelők között
Összeállítható felhasználói felület: A jövőbeni fejlett felhasználói felületi funkciók alapja

Vészhelyzeti tartalék a terminál kompatibilitás érdekében:

AUTOHAND_LEGACY_UI=1 autohand

Megjegyzés: Ez a funkció kísérleti jellegű, és lehetnek szélső esetek. Az alapértelmezett ora-alapú felhasználói felület stabil és teljesen működőképes marad.

Frissítési ellenőrzés

Ha a checkForUpdates engedélyezve van (alapértelmezett), a Autohand indításkor ellenőrzi az új kiadásokat:

> Autohand v0.6.8 (abc1234) ✓ Up to date

Ha elérhető frissítés:

> Autohand v0.6.7 (abc1234) ⬆ Update available: v0.6.8
  ↳ Run: curl -fsSL https://autohand.ai/install.sh | sh

Hogyan működik:

Lekéri a GitHub API legújabb kiadását
A gyorsítótárak eredménye ~/.autohand/version-check.json
Csak egyszer ellenőrzi updateCheckInterval óránként (alapértelmezett: 24)
Nem blokkoló: az indítás akkor is folytatódik, ha az ellenőrzés sikertelen

Letiltása:

{
  "ui": {
    "checkForUpdates": false
  }
}

Vagy környezeti változón keresztül:

export AUTOHAND_SKIP_UPDATE_CHECK=1

Ügynök beállításai

Az ügynök viselkedésének és iterációs korlátainak szabályozása.

{
  "agent": {
    "maxIterations": 100,
    "enableRequestQueue": true,
    "toolSelectionCache": true,
    "autoMemory": true,
    "idleLogoutEnabled": true,
    "debug": false
  }
}

Mező	Típus	Alapértelmezett	Leírás
`maxIterations`	szám	`100`	Maximális szerszámiterációk felhasználói kérésenként a leállítás előtt
`enableRequestQueue`	logikai	`true`	Lehetővé teszi a felhasználók számára, hogy kéréseket írjanak be és sorba állítsanak, miközben az ügynök dolgozik
`toolSelectionCache`	logikai	`true`	Gyorsítótárazza a körönkénti szerszámséma helyi kiválasztását az egyenértékű szerszámkiválasztási bemenethez
`autoMemory`	logikai	`true`	Tartós felhasználói/projektmemóriák kibontása és mentése sikeres interaktív fordulatok után
`idleLogoutEnabled`	logikai	`true`	Jelentkezzen ki a hitelesített interaktív munkamenetekből az üresjárati időtúllépés után
`debug`	logikai	`false`	Részletes hibakeresési kimenet engedélyezése (naplózza az ügynök belső állapotát az stderr-be)

Eszközséma kiválasztása

A Autohand nem küld el minden teljes eszközsémát minden LLM-kérelemnél. A rendszerprompt tartalmaz egy kompakt eszközképesség-katalógust, és minden kérés csak egy kis konkrét sémát tesz közzé, amely a következők közül választható ki:

Az alapvető felderítési eszközök, például tool_search, read_file, fff_find és fff_grep
Szándékhoz illő eszközök szerkesztési, ellenőrzési, git, böngésző, web, függőségi vagy projektkövetési munkákhoz
A legutóbbi tool_search hívások során kért vagy kifejezetten név szerint megemlített eszközök

Ezzel elkerülhető a nagy előzetes kontextusköltség, ha az összes eszközséma elküldése a felhasználói szándék ismertsége előtt felmerül. toolSelectionCache csak a helyi választó gyorsítótárát vezérli az egyenértékű fordulatokhoz; nem hajt végre felhasználói előtti LLM-bemelegítést, és nem kényszerít ki nagy gyorsítótárazott prompt előtagot.

A helyi választó gyorsítótárának letiltása:

{
  "agent": {
    "toolSelectionCache": false
  }
}

A hitelesített, régóta működő ügynöki munkamenetek életben tartásához, amíg munkára várnak:

{
  "agent": {
    "idleLogoutEnabled": false
  }
}

Egyetlen folyamathoz használja a autohand --no-idle-logout kódot, vagy állítsa be a AUTOHAND_NO_IDLE_LOGOUT=1 értéket.

Hibakeresési mód

Engedélyezze a hibakeresési módot az ügynök belső állapotának részletes naplózásához (reakcióhurok iterációi, prompt felépítés, munkamenet részletei). A kimenet az stderr-hez megy, hogy elkerülje a normál kimenet zavarását.

Háromféleképpen engedélyezheti a hibakeresési módot (elsőbbségi sorrendben):

CLI jelző: autohand -d vagy autohand --debug
Környezeti változó: AUTOHAND_DEBUG=1
Konfigurációs fájl: Állítsa be: agent.debug: true

Kérési sor

Ha a enableRequestQueue engedélyezve van, folytathatja az üzenetek beírását, miközben az ügynök feldolgoz egy korábbi kérést. A bevitel a sorba kerül, és automatikusan feldolgozásra kerül, amikor az aktuális feladat befejeződik.

Írja be az üzenetet, és nyomja meg az Enter billentyűt, hogy hozzáadja a sorhoz
Az állapotsor azt mutatja, hogy hány kérés van sorban
A kérések feldolgozása FIFO (first-in, first-out) sorrendben történik
A sor maximális mérete 10 kérés

Engedélyek beállításai

A szerszámengedélyek finom vezérlése.

{
  "permissions": {
    "mode": "interactive",
    "whitelist": [
      "run_command:npm *",
      "run_command:bun *",
      "run_command:git status"
    ],
    "blacklist": ["run_command:rm -rf *", "run_command:sudo *"],
    "rules": [
      {
        "tool": "run_command",
        "pattern": "npm test",
        "action": "allow"
      }
    ],
    "rememberSession": true
  }
}

`mode`

Érték	Leírás
`"interactive"`	Jóváhagyás kérése veszélyes műveletekhez (alapértelmezett)
`"unrestricted"`	Nincsenek felszólítások, engedélyezzen mindent
`"restricted"`	Minden veszélyes művelet megtagadása

`whitelist`

Szerszámminták sora, amelyek soha nem igényelnek jóváhagyást.

["run_command:npm *", "run_command:bun test"]

`blacklist`

Mindig blokkolt szerszámminták tömbje.

["run_command:rm -rf /", "run_command:sudo *"]

`rules`

Finom szemcsés engedélyezési szabályok.

| Mező | Típus | Leírás | | --------- | --------- | -------------------------------------------- | ---------- | -------------- | | tool | húr | A megfelelő eszköznév | | pattern | húr | Opcionális minta az érvekhez való illeszkedéshez | | action | "allow" | "deny" | "prompt" | Intézkedések |

`rememberSession`

Típus	Alapértelmezett	Leírás
logikai	`true`	Emlékezzen az ülés jóváhagyási határozataira

Helyi projektengedélyek

Minden projektnek saját engedélybeállításai lehetnek, amelyek felülírják a globális konfigurációt. Ezeket a projekt gyökérkönyvtárában a .autohand/settings.local.json tartalmazza.

Amikor jóváhagy egy fájlműveletet (szerkesztés, írás, törlés), a rendszer automatikusan ebbe a fájlba menti, így nem kéri újra ugyanazt a műveletet ebben a projektben.

{
  "version": 1,
  "permissions": {
    "whitelist": [
      "apply_patch:src/components/Button.tsx",
      "write_file:package.json",
      "run_command:bun test"
    ]
  }
}

Hogyan működik:

Amikor jóváhagy egy műveletet, a rendszer a következőbe menti: .autohand/settings.local.json
Legközelebb ugyanazt a műveletet a rendszer automatikusan jóváhagyja
A helyi projektbeállítások egyesülnek a globális beállításokkal (a helyi beállítások elsőbbséget élveznek)
Adja hozzá a .autohand/settings.local.json kódot a .gitignore-hoz, hogy a személyes beállítások privátak maradjanak

Mintaformátum:

tool_name:path - Fájlműveletekhez (pl. apply_patch:src/file.ts)
tool_name:command args - Parancsokhoz (pl. run_command:npm test)

Megtekintési engedélyek

Jelenlegi engedélybeállításait kétféleképpen tekintheti meg:

CLI jelző (nem interaktív):

autohand --permissions

Ez a következőket jeleníti meg:

Jelenlegi engedélyezési mód (interaktív, korlátlan, korlátozott)
Munkaterület és konfigurációs fájlok elérési útjai
Minden jóváhagyott minta (engedélyezőlista)
Minden elutasított minta (feketelista)
Összefoglaló statisztika

Interaktív parancs:

/permissions

Interaktív módban a /permissions parancs ugyanazokat az információkat és lehetőségeket biztosít a következőkhöz:

Elemek eltávolítása az engedélyezési listáról
Távolítsa el az elemeket a feketelistáról
Törölje az összes mentett engedélyt

Patch mód

A Patch mód lehetővé teszi megosztható, git-kompatibilis javítás létrehozását a munkaterület-fájlok módosítása nélkül. Ez hasznos:

A kód felülvizsgálata a változtatások alkalmazása előtt
Az AI által generált változások megosztása a csapat tagjaival
Reprodukálható változáskészletek készítése
CI/CD folyamatok, amelyeknek alkalmazása nélkül kell rögzíteni a változásokat

Használat

# Generate patch to stdout
autohand --prompt "add user authentication" --patch

# Save to file
autohand --prompt "add user authentication" --patch --output auth.patch

# Pipe to file (alternative)
autohand --prompt "refactor api handlers" --patch > refactor.patch

Viselkedés

Ha --patch meg van adva:

Automatikus megerősítés: Minden visszaigazolás automatikusan elfogadásra kerül (--yes)
Nincsenek felszólítások: Nem jelennek meg jóváhagyási értesítések (--unrestricted vélelmezett)
Csak előnézet: A változtatásokat rögzíti, de NEM írja lemezre
Kikényszerített biztonság: A feketelistán szereplő műveletek (.env, SSH-kulcsok, veszélyes parancsok) továbbra is blokkolva vannak

Javítások alkalmazása

A címzettek szabványos git parancsokkal alkalmazhatják a javítást:

# Check what would be applied (dry-run)
git apply --check changes.patch

# Apply the patch
git apply changes.patch

# Apply with 3-way merge (handles conflicts better)
git apply -3 changes.patch

# Apply and stage changes
git apply --index changes.patch

# Reverse a patch
git apply -R changes.patch

Patch formátum

A generált javítás a git egységes diff formátumát követi:

diff --git a/src/auth.ts b/src/auth.ts
new file mode 100644
--- /dev/null
+++ b/src/auth.ts
@@ -0,0 +1,15 @@
+export function authenticate(user: string, password: string) {
+  // Implementation here
+}

diff --git a/src/index.ts b/src/index.ts
--- a/src/index.ts
+++ b/src/index.ts
@@ -1,5 +1,7 @@
 import express from 'express';
+import { authenticate } from './auth';

 const app = express();
+app.use(authenticate);

Kilépési kódok

Kód	Jelentése
`0`	Siker, patch generált
`1`	Hiba (hiányzó `--prompt`, engedély megtagadva stb.)

Kombinálva más zászlókkal

# Use specific model
autohand --prompt "optimize queries" --patch --model gpt-4o

# Specify workspace
autohand --prompt "add tests" --patch --path ./my-project

# Use custom config
autohand --prompt "refactor" --patch --config ~/.autohand/work.json

Csapatmunkafolyamat-példa

# Developer A: Generate patch for a feature
autohand --prompt "implement user dashboard with charts" --patch --output dashboard.patch

# Share via git (create PR with just the patch file)
git checkout -b patch/dashboard
git add dashboard.patch
git commit -m "Add dashboard feature patch"
git push

# Developer B: Review and apply
git fetch origin patch/dashboard
git apply dashboard.patch
# Run tests, review code, then commit
git add -A && git commit -m "feat: add user dashboard with charts"

Hálózati beállítások

{
  "network": {
    "maxRetries": 3,
    "timeout": 30000,
    "retryDelay": 1000
  }
}

Mező	Típus	Alapértelmezett	Max	Leírás
`maxRetries`	szám	`3`	`5`	Próbálkozzon újra sikertelen API-kérésekkel
`timeout`	szám	`30000`	-	Kérelem időtúllépése ezredmásodpercben
`retryDelay`	szám	`1000`	-	Az újrapróbálkozások közötti késleltetés ezredmásodpercben

Telemetriai beállítások

A telemetria alapértelmezés szerint le van tiltva (feliratkozás). Engedélyezze a Autohand fejlesztéséhez.

{
  "telemetry": {
    "enabled": false,
    "apiBaseUrl": "https://api.autohand.ai",
    "batchSize": 20,
    "flushIntervalMs": 60000,
    "maxQueueSize": 500,
    "maxRetries": 3,
    "enableSessionSync": true,
    "companySecret": ""
  }
}

Mező	Típus	Alapértelmezett	Leírás
`enabled`	logikai	`false`	Telemetria engedélyezése/letiltása (feliratkozás)
`apiBaseUrl`	húr	`https://api.autohand.ai`	Telemetria API végpont
`batchSize`	szám	`20`	Az automatikus kiürítés előtt kötegelt események száma
`flushIntervalMs`	szám	`60000`	Öblítési időköz ezredmásodpercben (1 perc)
`maxQueueSize`	szám	`500`	Maximális sorméret a régi események eldobása előtt
`maxRetries`	szám	`3`	Próbálkozzon újra sikertelen telemetriai kérések esetén
`enableSessionSync`	logikai	`true`	Szinkronizálja a munkameneteket a felhővel a csapatfunkciókhoz, ha a telemetria engedélyezve van
`companySecret`	húr	`""`	Vállalati titok API-hitelesítéshez

A szolgáltató/modell telemetria tartalmazza az aktív szolgáltatói azonosítót, a modellazonosítót és az elérhető nem titkos metaadatokat, például az egyéni szolgáltató megjelenítési nevét, API-formátumát, érvelési erőfeszítéseit és kontextusablakát. Az API-kulcsok és a vivőjogkivonatok soha nem szerepelnek benne.

Külső ügynökök

Egyéni ügynökdefiníciók betöltése külső könyvtárakból.

{
  "externalAgents": {
    "enabled": true,
    "paths": ["~/.autohand/agents", "/team/shared/agents"]
  }
}

Mező	Típus	Alapértelmezett	Leírás
`enabled`	logikai	`false`	Külső ügynök betöltésének engedélyezése
`paths`	string[]	`[]`	Könyvtárak az ügynökök betöltéséhez

Skills System

A készségek olyan utasításcsomagok, amelyek speciális utasításokat adnak az AI-ügynöknek. Úgy működnek, mint az igény szerinti AGENTS.md fájlok, amelyek bizonyos feladatokhoz aktiválhatók.

Készségek felfedező helyek

A készségek több helyről fedezhetők fel, és a későbbi források élveznek elsőbbséget:

Helyszín	Forrásazonosító	Leírás
`~/.codex/skills/**/SKILL.md`	`codex-user`	Felhasználói szintű Codex készségek (rekurzív)
`~/.claude/skills/*/SKILL.md`	`claude-user`	Felhasználói szintű Claude-készségek (egy szint)
`~/.autohand/skills/**/SKILL.md`	`autohand-user`	Felhasználói szintű Autohand készségek (rekurzív)
`<project>/.claude/skills/*/SKILL.md`	`claude-project`	Projektszintű Claude-készségek (egy szint)
`<project>/.autohand/skills/**/SKILL.md`	`autohand-project`	Projekt szintű Autohand készségek (rekurzív)

Automatikus másolási viselkedés

A Codex vagy Claude helyekről felfedezett készségek automatikusan átmásolódnak a megfelelő Autohand helyre:

~/.codex/skills/ és ~/.claude/skills/ → ~/.autohand/skills/
<project>/.claude/skills/ → <project>/.autohand/skills/

A Autohand helyeken meglévő készségek soha nem íródnak felül.

SKILL.md formátum

A YAML frontmatter-t használó készségek, majd a leértékelési tartalom:

---
name: my-skill-name
description: Brief description of the skill
license: MIT
compatibility: Works with Node.js 18+
allowed-tools: read_file write_file run_command
metadata:
  author: your-name
  version: "1.0.0"
---

# My Skill

Detailed instructions for the AI agent...

Mező	Kötelező	Max hossz	Leírás
`name`	Igen	64 karakter	Kisbetűs alfanumerikus, csak kötőjelekkel
`description`	Igen	1024 karakter	A készség rövid leírása
`license`	Nem	-	Licencazonosító (pl. MIT, Apache-2.0)
`compatibility`	Nem	500 karakter	Kompatibilitási megjegyzések
`allowed-tools`	Nem	-	Az engedélyezett eszközök szóközzel tagolt listája
`metadata`	Nem	-	További kulcs-érték metaadatok

Beviteli előtagok

A Autohand támogatja a speciális előtagokat a beviteli promptban:

Előtag	Leírás	Példa
`/`	Slash parancsok	`/help`, `/model`, `/quit`, `/exit`
`@`	Fájl említések (automatikus kiegészítés)	`@src/index.ts`
`$`	Szakértelem említése (automatikus kiegészítés)	`$frontend-design`, `$code-review`
`!`	A terminálparancsok közvetlen futtatása	`! git status`, `! ls -la`

Képességmegemlítések ($):

Írja be a következőt: $, majd karaktereket az automatikus kiegészítéssel elérhető készségek megtekintéséhez
A Tab elfogadja a felső javaslatot (pl. $frontend-design)
A készségek a következőből fedezhetők fel: ~/.autohand/skills/ és <project>/.autohand/skills/
Az aktivált készségek a prompthoz vannak csatolva, mint speciális utasítások az aktuális munkamenethez
Az előnézeti panel a készség metaadatait mutatja (név, leírás, aktiválási állapot)

Shell-parancsok (!):

A parancsok az aktuális munkakönyvtárban futnak
A kimenet közvetlenül a terminálon jelenik meg
Nem megy az LLM-be
30 másodperces időtúllépés
A végrehajtás után visszatér a prompthoz

Slash parancsok

`/skills` - Csomagkezelő

Parancs	Leírás
`/skills`	Sorolja fel az összes elérhető készséget
`/skills use <name>`	Képesség aktiválása az aktuális munkamenethez
`/skills deactivate <name>`	Készség deaktiválása
`/skills info <name>`	Részletes képzettségi információk megjelenítése
`/skills install`	Tallózás és telepítés a közösségi nyilvántartásból
`/skills install @<slug>`	Telepítsen közösségi készségeket a slug
`/skills search <query>`	Keresés a közösségi készségek nyilvántartásában
`/skills trending`	Felkapott közösségi készségek megjelenítése
`/skills remove <slug>`	Közösségi készség eltávolítása
`/skills new`	Hozzon létre új készségeket interaktívan
`/skills feedback <slug> <1-5>`	Értékeljen egy közösségi képességet

`/learn` - LLM-alapú Skill Advisor

Parancs	Leírás
`/learn`	A projekt elemzése és készségek ajánlása (gyors szkennelés)
`/learn deep`	Mélyszkennelési projekt (forrásfájlokat olvas) a célzottabb eredmények érdekében
`/learn update`	A projekt újraelemzése és az LLM által generált elavult készségek regenerálása

A /learn kétfázisú LLM-folyamatot használ:

1. fázis – Elemzés + Rangsorolás + Ellenőrzés: Ellenőrzi a projekt szerkezetét, auditálja a telepített készségeket redundanciák/konfliktusok szempontjából, és rangsorolja a közösségi készségeket relevancia szerint (0-100).
2. fázis – Létrehozás (feltételes): Ha egyik közösségi képesség sem ér el 60 feletti pontszámot, felajánlja a projektjéhez szabott egyéni képesség létrehozását. A generált készségek metaadatokat (agentskill-source: llm-generated, agentskill-project-hash) tartalmaznak, így a /learn update képes észlelni, ha megváltozik a kódbázis, és újra előállíthatja az elavult készségeket.

Automatikus készséggenerálás (`--auto-skill`)

A --auto-skill CLI jelző készségeket generál az interaktív tanácsadói folyamat nélkül:

autohand --auto-skill

Ez:

Elemezze a projekt felépítését (package.json, követelmények.txt stb.)
Nyelvek, keretrendszerek és minták észlelése
Generáljon 3 releváns készséget az LLM segítségével
Mentse el a készségeket ide: <project>/.autohand/skills/

A célzottabb, interaktívabb élmény érdekében használja inkább a /learn kódot egy munkameneten belül.

Az észlelt minták a következők:

Nyelvek: TypeScript, JavaScript, Python, Rust, Go
Frameworks: React, Next.js, Vue, Express, Flask, Django
Minták: CLI eszközök, tesztelés, monorepo, Docker, CI/CD

API beállítások

Backend API konfiguráció a csapatfunkciókhoz.

{
  "api": {
    "baseUrl": "https://api.autohand.ai",
    "companySecret": "sk-team-xxx"
  }
}

Mező	Típus	Alapértelmezett	Leírás
`baseUrl`	húr	`https://api.autohand.ai`	API-végpont
`companySecret`	húr	-	Csapat/vállalati titok a megosztott funkciókhoz

Környezeti változókkal is beállítható:

AUTOHAND_API_URL → api.baseUrl
AUTOHAND_SECRET → api.companySecret

Hitelesítési beállítások

Hitelesítés és felhasználói munkamenet konfigurálása.

{
  "auth": {
    "token": "your-auth-token",
    "user": {
      "id": "user-id",
      "email": "user@example.com",
      "name": "User Name",
      "avatar": "https://example.com/avatar.png"
    },
    "expiresAt": "2025-12-31T23:59:59Z"
  }
}

Mező	Típus	Alapértelmezett	Leírás
`token`	húr	-	Hitelesítési token API-hozzáféréshez
`user`	tárgy	-	Hitelesített felhasználói adatok
`user.id`	húr	-	Felhasználói azonosító
`user.email`	húr	-	Felhasználó e-mail címe
`user.name`	húr	-	Felhasználó megjelenített név
`user.avatar`	húr	-	Felhasználói avatar URL-je (nem kötelező)
`expiresAt`	húr	-	Token lejárati időbélyegzője (ISO 8601 formátum)

Közösségi készségek beállításai

Konfiguráció a közösségi készségek felfedezéséhez és kezeléséhez.

{
  "communitySkills": {
    "enabled": true,
    "showSuggestionsOnStartup": true,
    "autoBackup": true
  }
}

Mező	Típus	Alapértelmezett	Leírás
`enabled`	logikai	`true`	Közösségi készségek funkcióinak engedélyezése
`showSuggestionsOnStartup`	logikai	`true`	Képességi javaslatok megjelenítése indításkor, ha nem állnak rendelkezésre szállítói ismeretek
`autoBackup`	logikai	`true`	A felfedezett szállítói ismeretek automatikus biztonsági mentése API

Megosztási beállítások

Konfiguráció a munkamenet megosztásához a /share paranccsal. A munkamenetek a autohand.link címen találhatók.

{
  "share": {
    "enabled": true
  }
}

Mező	Típus	Alapértelmezett	Leírás
`enabled`	logikai	`true`	A `/share` parancs engedélyezése/letiltása

YAML formátum

share:
  enabled: true

Munkamenet-megosztás letiltása

Ha biztonsági vagy adatvédelmi okokból ki szeretné kapcsolni a munkamenet-megosztást:

{
  "share": {
    "enabled": false
  }
}

Ha le van tiltva, a /share futtatásakor a következő jelenik meg:

Session sharing is disabled.
To enable, set share.enabled: true in your config file.

Beállítások szinkronizálása

A Autohand szinkronizálhatja a konfigurációt az eszközök között a bejelentkezett felhasználók számára. A beállításokat a Cloudflare R2 biztonságosan tárolja, és a feltöltés előtt titkosítja.

{
  "sync": {
    "enabled": true,
    "interval": 300000,
    "exclude": [],
    "includeTelemetry": false,
    "includeFeedback": false
  }
}

Mező	Típus	Alapértelmezett	Leírás
`enabled`	logikai	`true` (naplózva)	Beállítások szinkronizálásának engedélyezése/letiltása
`interval`	szám	`300000`	Szinkronizálási idő ezredmásodpercben (alapértelmezett: 5 perc)
`exclude`	string[]	`[]`	Globális minták a szinkronizálásból kizárandó
`includeTelemetry`	logikai	`false`	Telemetriai adatok szinkronizálása (felhasználói hozzájárulás szükséges)
`includeFeedback`	logikai	`false`	Visszajelzési adatok szinkronizálása (felhasználói hozzájárulás szükséges)

CLI zászló

# Disable sync for this session
autohand --sync-settings=false

# Enable sync (default for logged users)
autohand --sync-settings

Mi lesz szinkronizálva

Alapértelmezés szerint ezek az elemek szinkronizálva vannak a bejelentkezett felhasználók számára:

Konfiguráció (config.json) - Az API-kulcsok a feltöltés előtt titkosítva vannak
Egyéni ügynökök (agents/)
Közösségi készségek (community-skills/)
Felhasználói akasztók (hooks/)
Memória (memory/)
Projektismeret (projects/)
Munkamenetek előzményei (sessions/)
Megosztott tartalom (share/)
Egyéni készségek (skills/)

Mi nem szinkronizál (alapértelmezés szerint)

Eszközazonosító (device-id) - Eszközönként egyedi
Hibanaplók (error.log) - Csak helyi
Verziógyorsítótár (version-*.json) - Helyi gyorsítótár fájlok

Beleegyezés alapú szinkronizálás

Ezek az elemek kifejezett feliratkozást igényelnek a konfigurációban:

Telemetriai adatok - Állítsa be a sync.includeTelemetry: true szinkronizálást
Visszajelzési adatok - Állítsa be a sync.includeFeedback: true szinkronizálását

{
  "sync": {
    "enabled": true,
    "includeTelemetry": true,
    "includeFeedback": true
  }
}

Konfliktusmegoldás

Ha ütközések lépnek fel (ugyanaz a fájl több eszközön módosítva), a felhőverzió nyer. Ez biztosítja a következetességet az új eszközökön való bejelentkezéskor.

Biztonság

A config.json API-kulcsait és egyéb bizalmas adatait a rendszer a hitelesítési token segítségével titkosítja a feltöltés előtt. Csak az Ön hitelesítő adataival lehet visszafejteni.

Mi van titkosítva:

apiKey nevű mezők
Key, Token, Secret végződő mezők
A password mező

Hogyan működik

Indításkor: Ha be van jelentkezve, a szinkronizálási szolgáltatás automatikusan elindul
5 percenként: A beállításokat összehasonlítja a felhőalapú tárolással
A felhő nyer: A távoli módosítások letöltése először történik meg
Helyi feltöltések: Új helyi módosítások kerülnek feltöltésre
Kilépéskor: A szinkronizálási szolgáltatás kecsesen leáll

Fájlok kizárása

Kizárhat bizonyos fájlokat vagy mintákat a szinkronizálásból:

{
  "sync": {
    "enabled": true,
    "exclude": ["custom-local-config.json", "temp/*"]
  }
}

YAML formátum

sync:
  enabled: true
  interval: 300000
  exclude: []
  includeTelemetry: false
  includeFeedback: false

MCP beállítások

Állítsa be az MCP-kiszolgálókat (Model Context Protocol) a Autohand külső eszközökkel történő bővítésére.

{
  "mcp": {
    "enabled": true,
    "servers": [
      {
        "name": "filesystem",
        "transport": "stdio",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
        "env": {},
        "autoConnect": true
      },
      {
        "name": "context7",
        "transport": "http",
        "url": "https://mcp.context7.com/mcp",
        "headers": {
          "CONTEXT7_API_KEY": "ctx7sk-your-api-key"
        },
        "autoConnect": true
      }
    ]
  }
}

`mcp.enabled`

Típus: boolean
Alapértelmezett: true
Leírás: Az összes MCP-támogatás engedélyezése vagy letiltása. Ha false, akkor az indításkor nem csatlakozik szerver, és az MCP-eszközök nem érhetők el.

`mcp.servers`

Típus: McpServerConfigEntry[]
Alapértelmezett: []
Leírás: MCP szerver konfigurációk tömbje.

Szerver beviteli mezői

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`name`	`string`	Igen	-	Egyedi szerverazonosító
`transport`	`"stdio"` \| `"sse"` \| `"http"`	Igen	-	Szállítás típusa
`command`	`string`	Igen (stdio)	-	Parancs a szerverfolyamat elindításához
`args`	`string[]`	Nem	`[]`	Érvek a parancs mellett
`url`	`string`	Igen (sse/http)	-	Szervervégpont URL
`headers`	`Record<string, string>`	Nem	`{}`	Egyéni HTTP-fejlécek http/sse szállításhoz (pl. hitelesítési tokenek)
`env`	`Record<string, string>`	Nem	`{}`	A kiszolgálónak átadott környezeti változók
`autoConnect`	`boolean`	Nem	`true`	Automatikus csatlakozás indításkor

A szerverek aszinkron módon csatlakoznak a háttérben az indítás során anélkül, hogy blokkolnák a promptot. A /mcp segítségével interaktívan kezelheti a szervereket, vagy a /mcp add segítségével böngészhet a közösségi nyilvántartásban, vagy adhat hozzá egyéni szervereket.

A teljes MCP-dokumentációért lásd: docs/mcp.md.

Hooks beállítások

Konfiguráció életciklus-horogokhoz, amelyek shell-parancsokat futtatnak az ügynökeseményeken. A részletekért lásd a [Hooks dokumentációt] (./hooks.md).

{
  "hooks": {
    "enabled": true,
    "hooks": [
      {
        "event": "pre-tool",
        "command": "echo \"Running tool: $HOOK_TOOL\" >> ~/.autohand/hooks.log",
        "description": "Log all tool executions",
        "enabled": true
      },
      {
        "event": "file-modified",
        "command": "./scripts/on-file-change.sh",
        "description": "Custom file change handler",
        "filter": { "path": ["src/**/*.ts"] }
      },
      {
        "event": "post-response",
        "command": "curl -X POST https://api.example.com/webhook -d '{\"tokens\": $HOOK_TOKENS}'",
        "description": "Track token usage",
        "async": true
      }
    ]
  }
}

`hooks`

Mező	Típus	Alapértelmezett	Leírás
`enabled`	logikai	`true`	Az összes hook engedélyezése/letiltása globálisan
`hooks`	tömb	`[]`	Horogdefiníciók tömbje

Hook meghatározása

Mező	Típus	Kötelező	Alapértelmezett	Leírás
`event`	húr	Igen	-	Bekapcsolandó esemény
`command`	húr	Igen	-	Shell parancs végrehajtásához
`description`	húr	Nem	-	A `/hooks` kijelző leírása
`enabled`	logikai	Nem	`true`	Aktív-e a horog
`timeout`	szám	Nem	`5000`	Időtúllépés ezredmásodpercben
`async`	logikai	Nem	`false`	Futtasson blokkolás nélkül
`filter`	tárgy	Nem	-	Szűrés szerszám vagy útvonal szerint

Hook események

Esemény	Amikor kirúgták
`pre-tool`	Mielőtt bármilyen eszköz végrehajtaná
`post-tool`	A szerszám befejezése után
`file-modified`	A fájl létrehozásakor/módosításakor/törlésekor
`pre-prompt`	Mielőtt elküldené az LLM-nek
`post-response`	Miután az LLM válaszol
`session-error`	Hiba esetén

Környezeti változók

Amikor a hook fut, ezek a környezeti változók állnak rendelkezésre:

Változó	Leírás
`HOOK_EVENT`	Esemény neve
`HOOK_WORKSPACE`	Munkaterület gyökérútvonala
`HOOK_TOOL`	Szerszámnév (szerszámesemények)
`HOOK_ARGS`	JSON-kódolt eszköz args
`HOOK_SUCCESS`	igaz/hamis (utóeszköz)
`HOOK_PATH`	Fájl elérési útja (fájlmódosított)
`HOOK_TOKENS`	Felhasznált tokenek (válasz után)

Chrome-bővítmény beállításai

Irányítsd a Autohand Chrome-bővítmény integrációját. Tekintse meg a teljes útmutatót: Autohand Chrome-ban.

{
  "chrome": {
    "extensionId": "your-extension-id",
    "enabledByDefault": false,
    "browser": "auto",
    "userDataDir": "/path/to/chrome/user-data",
    "profileDirectory": "Default",
    "installUrl": "https://autohand.ai/chrome"
  }
}

Kulcs	Típus	Alapértelmezett	Leírás
`extensionId`	`string`	—	Telepített Chrome-bővítményazonosító a közvetlen átadáshoz
`enabledByDefault`	`boolean`	`false`	A böngészőhíd automatikus indítása a CLI
`browser`	`string`	`"auto"`	Előnyben részesített Chromium böngésző: `auto`, `chrome`, `chromium`, `brave`, `edge`
`userDataDir`	`string`	—	Böngésző felhasználói adatok könyvtára a megfelelő profil megcélzásához
`profileDirectory`	`string`	—	Böngészőprofil-könyvtár neve (pl. `"Default"`, `"Profile 1"`)
`installUrl`	`string`	—	Tartalék URL, ha a bővítményazonosító nincs konfigurálva

CLI zászlók

autohand --chrome          # Start with browser bridge enabled
autohand --no-chrome       # Start with browser bridge disabled

Slash parancsok

/chrome                    # Open Chrome integration panel
/chrome disconnect         # Close the browser bridge connection

Teljes példa

JSON formátum (`~/.autohand/config.json`)

{
  "provider": "openrouter",
  "openrouter": {
    "apiKey": "sk-or-v1-your-key-here",
    "baseUrl": "https://openrouter.ai/api/v1",
    "model": "your-modelcard-id-here"
  },
  "ollama": {
    "baseUrl": "http://localhost:11434",
    "model": "llama3.2"
  },
  "workspace": {
    "defaultRoot": "~/projects",
    "allowDangerousOps": false
  },
  "ui": {
    "theme": "dark",
    "autoConfirm": false,
    "showCompletionNotification": true,
    "showThinking": true,
    "terminalBell": true,
    "checkForUpdates": true,
    "updateCheckInterval": 24
  },
  "agent": {
    "maxIterations": 100,
    "enableRequestQueue": true,
    "toolSelectionCache": true,
    "idleLogoutEnabled": true,
    "debug": false
  },
  "permissions": {
    "mode": "interactive",
    "whitelist": ["run_command:npm *", "run_command:bun *"],
    "blacklist": ["run_command:rm -rf /"],
    "rememberSession": true
  },
  "network": {
    "maxRetries": 3,
    "timeout": 30000,
    "retryDelay": 1000
  },
  "telemetry": {
    "enabled": false,
    "apiBaseUrl": "https://api.autohand.ai",
    "batchSize": 20,
    "flushIntervalMs": 60000,
    "maxQueueSize": 500,
    "maxRetries": 3,
    "enableSessionSync": true
  },
  "externalAgents": {
    "enabled": false,
    "paths": []
  },
  "api": {
    "baseUrl": "https://api.autohand.ai"
  },
  "auth": {
    "token": "your-auth-token",
    "user": {
      "id": "user-id",
      "email": "user@example.com",
      "name": "User Name"
    }
  },
  "communitySkills": {
    "enabled": true,
    "showSuggestionsOnStartup": true,
    "autoBackup": true
  },
  "share": {
    "enabled": true
  },
  "sync": {
    "enabled": true,
    "interval": 300000,
    "includeTelemetry": false,
    "includeFeedback": false
  }
}

YAML formátum (`~/.autohand/config.yaml`)

provider: openrouter

openrouter:
  apiKey: sk-or-v1-your-key-here
  baseUrl: https://openrouter.ai/api/v1
  model: your-modelcard-id-here

ollama:
  baseUrl: http://localhost:11434
  model: llama3.2

workspace:
  defaultRoot: ~/projects
  allowDangerousOps: false

ui:
  theme: dark
  autoConfirm: false
  showCompletionNotification: true
  showThinking: true
  terminalBell: true
  checkForUpdates: true
  updateCheckInterval: 24

agent:
  maxIterations: 100
  enableRequestQueue: true
  toolSelectionCache: true
  idleLogoutEnabled: true
  debug: false

permissions:
  mode: interactive
  whitelist:
    - "run_command:npm *"
    - "run_command:bun *"
  blacklist:
    - "run_command:rm -rf /"
  rememberSession: true

network:
  maxRetries: 3
  timeout: 30000
  retryDelay: 1000

telemetry:
  enabled: false
  apiBaseUrl: https://api.autohand.ai
  batchSize: 20
  flushIntervalMs: 60000
  maxQueueSize: 500
  maxRetries: 3
  enableSessionSync: true

externalAgents:
  enabled: false
  paths: []

api:
  baseUrl: https://api.autohand.ai

auth:
  token: your-auth-token
  user:
    id: user-id
    email: user@example.com
    name: User Name

communitySkills:
  enabled: true
  showSuggestionsOnStartup: true
  autoBackup: true

share:
  enabled: true

sync:
  enabled: true
  interval: 300000
  includeTelemetry: false
  includeFeedback: false

TOML formátum (`~/.autohand/config.toml`)

provider = "openrouter"

[openrouter]
apiKey = "sk-or-v1-your-key-here"
baseUrl = "https://openrouter.ai/api/v1"
model = "your-modelcard-id-here"

[ollama]
baseUrl = "http://localhost:11434"
model = "llama3.2"

[workspace]
defaultRoot = "~/projects"
allowDangerousOps = false

[ui]
theme = "dark"
autoConfirm = false
showCompletionNotification = true
showThinking = true
terminalBell = true
checkForUpdates = true
updateCheckInterval = 24

[ui.customThemes.company.vars]
brand = "#7c3aed"
brandSoft = "#a78bfa"

[ui.customThemes.company.colors]
accent = "brand"
borderAccent = "brandSoft"
mdHeading = "brand"

[agent]
maxIterations = 100
enableRequestQueue = true
toolSelectionCache = true
idleLogoutEnabled = true
debug = false

[permissions]
mode = "interactive"
whitelist = ["run_command:npm *", "run_command:bun *"]
blacklist = ["run_command:rm -rf /"]
rememberSession = true

Címtárszerkezet

A Autohand az adatokat ~/.autohand/ (vagy $AUTOHAND_HOME) kódban tárolja:

~/.autohand/
├── config.json          # Main configuration
├── config.toml          # Alternative TOML config
├── config.yaml          # Alternative YAML config
├── device-id            # Unique device identifier
├── error.log            # Error log
├── feedback.log         # Feedback submissions
├── sessions/            # Session history
├── projects/            # Project knowledge base
├── memory/              # User-level memory
├── commands/            # Custom commands
├── agents/              # Agent definitions
├── tools/               # Custom meta-tools
├── feedback/            # Feedback state
└── telemetry/           # Telemetry data
    ├── queue.json
    └── session-sync-queue.json

Projektszintű könyvtár (a munkaterület gyökérkönyvtárában):

<project>/.autohand/
├── settings.local.json  # Local project permissions (gitignore this)
├── memory/              # Project-specific memory
├── skills/              # Project-specific skills
└── tools/               # Project-specific meta-tools

CLI-jelzők (konfig felülbírálása)

Ezek a jelzők felülírják a konfigurációs fájl beállításait:

Alapjelzők

zászló	Leírás
`-v, --version`	Az aktuális verzió kiadása
`-p, --prompt [text]`	Futtasson egyetlen utasítást parancs módban
`--path <path>`	Munkaterület gyökér felülbírálása
`--config <path>`	Egyéni konfigurációs fájl használata
`--model <model>`	Modell felülírása
`--temperature <n>`	Beállított mintavételi hőmérséklet (0-1)
`--thinking [level]`	Gondolkodási/érvelési mélység beállítása (nincs, normál, kiterjesztett)
`-y, --yes`	Automatikus megerősítési kérések
`--dry-run`	Előnézet végrehajtás nélkül
`-d, --debug`	Részletes hibakeresési kimenet engedélyezése
`--bare`	Minimális explicit mód; beállítja a `AUTOHAND_CODE_SIMPLE=1` értéket és letiltja a perjel parancsokat

Engedélyek és biztonság

zászló	Leírás
`--unrestricted`	Nincs jóváhagyási felszólítás
`--restricted`	Veszélyes műveletek megtagadása
`--permissions`	Jelenítse meg az aktuális engedélybeállításokat, és lépjen ki
`--no-idle-logout`	A hitelesített tétlen kijelentkezés letiltása a hosszan futó ügynöki munkamenetekhez
`--yolo [pattern]`	Eszközhívások megfelelő minta automatikus jóváhagyása (pl. `allow:read,write` vagy `deny:delete`)
`--timeout <seconds>`	Időtúllépés másodpercben az automatikus jóváhagyási módhoz

Git & Worktree

zászló	Leírás
`--worktree [name]`	Munkamenet futtatása elszigetelt git-munkafán (opcionális munkafa/ág neve)
`--tmux`	Indítás egy dedikált tmux munkamenetben (az `--worktree`-t jelenti; nem használható a `--no-worktree` kóddal)
`--no-worktree`	A git munkafa elkülönítésének letiltása automatikus módban
`-c, --auto-commit`	Változások automatikus véglegesítése a feladatok elvégzése után
`--patch`	Git javítás generálása változtatások alkalmazása nélkül
`--output <file>`	A javítás kimeneti fájlja (a --patch-el együtt használatos)

Automatikus mód

zászló	Leírás
`--auto-mode [prompt]`	Engedélyezze az interaktív automatikus módot, vagy indítson önálló hurkot egy soron belüli feladattal
`--max-iterations <n>`	Maximális automatikus módú iterációk (alapértelmezett: 50)
`--completion-promise <text>`	Befejezésjelző szövege (alapértelmezett: "KÉSZ")
`--checkpoint-interval <n>`	A Git minden N iterációt végrehajt (alapértelmezett: 5)
`--max-runtime <m>`	Maximális futási idő percekben (alapértelmezett: 120)
`--max-cost <d>`	Maximális API költség dollárban (alapértelmezett: 10)
`--interactive-on-complete`	Az automatikus mód vége után adja át közvetlenül az interaktív módba (csak TTY)

Készségek és tanulás

zászló	Leírás
`--auto-skill`	Készségek automatikus generálása projektelemzés alapján (lásd még: `/learn` az interaktív tanácsadóhoz)
`--learn`	Futtassa a `/learn` készségtanácsadót nem interaktív módon (a javasolt készségek elemzése és telepítése)
`--learn-update`	A projekt újraelemzése és az LLM által generált elavult készségek nem interaktív módon történő regenerálása
`--skill-install [name]`	Telepítsen egy közösségi képességet (megnyitja a böngészőt, ha nincs megadva név)
`--project`	A készség telepítése projektszintre (a --skill-install funkcióval)

Hitelesítés és fiók

zászló	Leírás
`--login`	Jelentkezzen be Autohand-fiókjába
`--logout`	Jelentkezzen ki Autohand-fiókjából
`--sync-settings`	A beállítások szinkronizálásának engedélyezése/letiltása (alapértelmezett: igaz a bejelentkezett felhasználók számára)

Beállítás és információ

zászló	Leírás
`--setup`	Futtassa a telepítővarázslót a Autohand
`--about`	Információk megjelenítése a Autohand-ról (verzió, linkek, hozzájárulási információk)
`--feedback`	Visszajelzés küldése a Autohand csapatának
`--settings`	A Autohand beállításainak konfigurálása (ugyanaz, mint a `/settings` interaktív módban)

Munkaterület és könyvtárak

zászló	Leírás
`--add-dir <path...>`	További könyvtárak hozzáadása a munkaterület hatóköréhez (többször is használható)

Futtatási módok

zászló	Leírás
`--mode <mode>`	Futtatási mód: interaktív (alapértelmezett), rpc vagy acp
`--acp`	A --mode acp rövidítése (Agent Client Protocol over stdio)
`--teammate-mode <mode>`	Csapat megjelenítési mód: automatikus, folyamatban lévő vagy tmux

UI és nyelv

zászló	Leírás
`--display-language <locale>`	Megjelenítési nyelv beállítása (pl. en, id, zh-cn, fr, de, ja)
`--search-engine <provider>`	Internetes keresőszolgáltató beállítása (google, brave, duckduckgo, párhuzamos)
`--cc, --context-compact`	Környezettömörítés engedélyezése (alapértelmezett: be)
`--no-cc, --no-context-compact`	Kontextustömörítés letiltása

Chrome integráció

zászló	Leírás
`--chrome`	A Chrome böngésző integrációjának engedélyezése (ugyanaz, mint `/chrome`)
`--no-chrome`	A Chrome böngésző integrációjának letiltása

Rendszerprompt

zászló	Leírás
`--sys-prompt <value>`	Cserélje ki a teljes rendszerpromptot (soron belüli karakterlánc vagy fájl elérési útja)
`--append-sys-prompt <value>`	Hozzáfűzés a rendszerprompthoz (soron belüli karakterlánc vagy fájl elérési útja)
`--system-prompt <value>`	Cserélje ki a teljes rendszerpromptot (soron belüli karakterlánc vagy fájl elérési útja)
`--system-prompt-file <path>`	Cserélje le a teljes rendszerprompt a fájltartalommal
`--append-system-prompt <value>`	Hozzáfűzés a rendszerprompthoz (soron belüli karakterlánc vagy fájl elérési útja)
`--append-system-prompt-file <path>`	Fájl tartalmának hozzáfűzése a rendszerprompthoz
`--mcp-config <path>`	Töltsön be egy explicit MCP konfigurációs fájlt
`--agents <json\|path>`	Explicit beépített ügynökök JSON vagy explicit ügynökök könyvtárának betöltése
`--plugin-dir <path>`	Töltsön be egy explicit plugin/meta-tool könyvtárat

Kísérletváltási parancsok

Parancs	Leírás
`autohand experiments list`	Sorolja fel a helyi és távoli funkciók azonosítóit, a forrást, az életciklus szakaszt és az állapotot
`autohand experiments status <feature>`	Mutasson egy szolgáltatáskapcsolót, konfigurációs elérési utat vagy távoli metaadatokat és állapotot
`autohand experiments refresh`	Távoli funkciójelzők letöltése a Autohand API-ból
`autohand experiments enable <feature>`	Konfigurációval támogatott szolgáltatáskapcsoló engedélyezése
`autohand experiments disable <feature>`	A konfigurációval támogatott szolgáltatáskapcsoló letiltása

A távoli funkciójelzők lekérése innen: /v1/feature-flags/evaluate, gyorsítótár a ~/.autohand/feature-flags.json címen történik, és az API által biztosított TTL lejárta után frissül. A features.environment segítségével válassza ki a távoli jelzőkörnyezetet, a features.remoteOverrides segítségével pedig a felhasználó által felülbírálható távoli jelzők helyi letiltásához.

A usage_v2 egy kísérleti funkciókapcsoló a /usage irányítópulthoz és a továbbfejlesztett /status Használat laphoz. Engedélyezze a következővel: autohand experiments enable usage_v2.

A token_usage_status egy kísérleti funkciókapcsoló (konfigurációs útvonal features.tokenUsageStatus, alapértelmezés szerint kikapcsolva), amely a valós idejű tokenhasználatot mutatja a működő állapotsorban – kumulatív tokenek felfelé (↑) és lefelé (↓) plusz g kontextusban, cc. ↑15.7k ↓3.2k · context: 6.0% (15.7k/262.1k). A kontextusablak modellenként van feloldva az összes szolgáltatónál. Engedélyezze a következővel: autohand experiments enable token_usage_status.

Slash parancsok

Az Autohand perjel parancsok gazdag készletét kínálja interaktív használatra. A javaslatok megtekintéséhez írja be a / kódot a REPL-be.

Munkamenet-kezelés

Parancs	Leírás
`/quit`	Kilépés az aktuális munkamenetből
`/exit`	Kilépés az aktuális munkamenetből
`/new`	Új beszélgetés indítása (memóriakivonattal)
`/clear`	Tiszta beszélgetés automatikus memóriakivonással
`/session`	Az aktuális munkamenet részleteinek megjelenítése
`/sessions`	Korábbi munkamenetek listája
`/resume`	Előző munkamenet folytatása
`/history`	A munkamenet-előzmények böngészése oldalszámozással
`/undo`	Git módosítások és utolsó forduló visszaállítása
`/export`	Munkamenet exportálása markdown/JSON/HTML
`/share`	Aktuális munkamenet megosztása
`/status`	Munkamenet állapotának megjelenítése
`/usage`	Modell, szolgáltató, kontextus és használati korlátok megjelenítése

Modell és szolgáltató

Parancs	Leírás
`/model`	LLM-modell váltása vagy konfigurálása
`/cc`	Kézi környezet tömörítése

Projektbeállítás

Parancs	Leírás
`/init`	Hozzon létre `AGENTS.md` fájlt az aktuális könyvtárban
`/setup`	Futtassa a telepítővarázslót a Autohand
`/add-dir`	Könyvtárak hozzáadása a munkaterület hatóköréhez

Ügynökök és csapatok

Parancs	Leírás
`/agents`	Az elérhető alügynökök listája
`/agents-new`	Hozzon létre egy új ügynököt a varázslón keresztül
`/squad`	Nyissa meg/kezelje az önálló Autohand Squad futtatókörnyezetet
`/team`	Csapat irányítása párhuzamos munkához
`/tasks`	Feladatok kezelése csapatban
`/message`	Üzenet küldése csapattársnak

Készségek

Parancs	Leírás
`/skills`	Készségek listája és kezelése
`/skills-new`	Új készség létrehozása
`/learn`	Tanulja meg és telepítse az ajánlott készségeket

Memória és beállítások

Parancs	Leírás
`/memory`	Tárolt emlékek megtekintése és kezelése
`/settings`	A Autohand beállításainak konfigurálása
`/statusline`	A szerző állapotsor mezőinek konfigurálása
`/experiments`	Kísérleti jellemzők kapcsolóinak váltása
`/sync`	Beállítások szinkronizálása eszközök között
`/import`	Importálhat munkameneteket, beállításokat, MCP-t, memóriát, készségeket és hook-okat a támogatott ügynökökről

Engedélyek és akasztók

Parancs	Leírás
`/permissions`	Szerszámengedélyek kezelése
`/hooks`	Életciklus-horogok kezelése

Hitelesítés

Parancs	Leírás
`/login`	Hitelesítés a Autohand API-val
`/logout`	Kijelentkezés a Autohand fiókból

Eszközök és segédprogramok

Parancs	Leírás
`/search`	Keresés az interneten
`/formatters`	Az elérhető kódformázók listája
`/lint`	Sorolja fel a rendelkezésre álló kódsorokat
`/completion`	Shell befejező szkriptek generálása
`/plan`	Megvalósítási terv létrehozása
`/review`	Kódellenőrzés végrehajtása
`/pr-review`	Lehívási kérelem áttekintése

IDE integráció

Parancs	Leírás
`/ide`	A futó IDE észlelése és csatlakozása

MCP (Model Context Protocol)

Parancs	Leírás
`/mcp`	Interaktív MCP-kiszolgálókezelő

Automatizálás

Parancs	Leírás
`/automode`	Indítsa el az autonóm kódolási módot
`/repeat`	Ismétlődő munkák ütemezése
`/yolo`	Yolo mód váltása (automatikus jóváhagyási eszközök)

Chrome integráció

Parancs	Leírás
`/chrome`	A Chrome böngésző integrációjának engedélyezése

UI és kijelző

Parancs	Leírás
`/help`	Az elérhető perjel parancsok és tippek megjelenítése
`/about`	Információk megjelenítése a következőről: Autohand
`/theme`	Színtéma módosítása
`/language`	Kijelző nyelvének módosítása
`/feedback`	Visszajelzés küldése a Autohand csapatának

Rendszerprompt testreszabás

Autohand lehetővé teszi az AI-ügynök által használt rendszerprompt testreszabását. Ez speciális munkafolyamatok, egyedi utasítások vagy más rendszerekkel való integráció esetén hasznos.

CLI zászlók

zászló	Leírás
`--sys-prompt <value>`	Cserélje ki a teljes rendszerprompt
`--append-sys-prompt <value>`	Tartalom hozzáfűzése az alapértelmezett rendszerprompthoz

Mindkét zászló elfogadja a következőket:

Inline karakterlánc: Közvetlen szövegtartalom
Fájl elérési útja: A promptot tartalmazó fájl elérési útja (automatikusan észlelve)

Fájlútvonal észlelése

Egy érték fájlútvonalként kezelendő, ha:

A következővel kezdődik: ./, ../, / vagy ~/
Windows meghajtóbetűjellel kezdődik (pl. C:\)
A következővel végződik: .txt, .md vagy .prompt
Útleválasztókat tartalmaz szóközök nélkül

Ellenkező esetben a rendszer soron belüli karakterláncként kezeli.

`--sys-prompt` (Teljes csere)

Ha rendelkezésre áll, ez teljesen lecseréli az alapértelmezett rendszerpromptot. Az ügynök NEM tölti be:

Alapértelmezett Autohand utasítások
AGENTS.md projekt utasítások
Felhasználói/projekt memóriák
Aktív készségek

# Inline string
autohand --sys-prompt "You are a Python expert. Be concise." --prompt "Write hello world"

# From file
autohand --sys-prompt ./custom-prompt.txt --prompt "Explain this code"

# Home directory
autohand --sys-prompt ~/.autohand/prompts/python-expert.md --prompt "Debug this function"

Példa egyéni prompt fájlra (custom-prompt.txt):

You are a specialized Python debugging assistant.

Rules:
- Focus only on Python code
- Always explain the root cause
- Suggest fixes with code examples
- Be concise and direct

`--append-sys-prompt` (Hozzáadás az alapértelmezetthez)

Ha rendelkezésre áll, ez hozzáfűzi a tartalmat a teljes alapértelmezett rendszerprompthoz. Az ügynök továbbra is betölti:

Alapértelmezett Autohand utasítások
AGENTS.md projekt utasítások
Felhasználói/projekt memóriák
Aktív készségek

A csatolt tartalom a legvégére kerül hozzáadásra.

# Inline string
autohand --append-sys-prompt "Always use TypeScript instead of JavaScript" --prompt "Create a function"

# From file
autohand --append-sys-prompt ./team-guidelines.md --prompt "Add error handling"

Példa hozzáfűző fájl (team-guidelines.md):

## Team Guidelines

- Use 2-space indentation
- Prefer functional patterns
- Add JSDoc comments to public APIs
- Run tests before committing

Elsőbbség

Ha mindkét zászló rendelkezésre áll:

A --sys-prompt teljes elsőbbséget élvez
A --append-sys-prompt figyelmen kívül hagyva

# --append-sys-prompt is ignored in this case
autohand --sys-prompt "Custom only" --append-sys-prompt "This is ignored"

Használati esetek

Használati eset	Ajánlott zászló
Egyedi ügynök személye	`--sys-prompt`
Minimális utasítások	`--sys-prompt`
Csapatirányelvek hozzáadása	`--append-sys-prompt`
Projektkonvenciók hozzáadása	`--append-sys-prompt`
Integráció külső rendszerekkel	`--sys-prompt`
Speciális hibakeresés	`--sys-prompt`

Hibakezelés

Forgatókönyv	Viselkedés
Üres érték	Hiba
A fájl nem található	Soron belüli karakterláncként kezelve
Üres fájl	Hiba
Fájl > 1 MB	Hiba
Engedély megtagadva	Hiba
Címtár elérési útja	Hiba

Példák

# Python expert mode
autohand --sys-prompt "You are a Python expert. Only write Python code." \
  --prompt "Create a web scraper"

# TypeScript enforcement
autohand --append-sys-prompt "Always use TypeScript, never JavaScript." \
  --prompt "Create a REST API"

# CI/CD integration (non-interactive)
autohand --sys-prompt ./ci-prompt.txt \
  --prompt "Fix the failing tests" \
  --unrestricted \
  --patch

# Custom team workflow
autohand --append-sys-prompt ~/.company/coding-standards.md \
  --prompt "Refactor this module"

Több könyvtár támogatása

Az Autohand a fő munkaterületen kívül több könyvtárral is működhet. Ez akkor hasznos, ha a projektben különböző könyvtárakban vannak függőségek, megosztott könyvtárak vagy kapcsolódó projektek.

CLI zászló

A --add-dir használatával további könyvtárakat adhat hozzá (többször is használható):

# Add a single additional directory
autohand --add-dir /path/to/shared-lib

# Add multiple directories
autohand --add-dir /path/to/lib1 --add-dir /path/to/lib2

# With unrestricted mode (auto-approve writes to all directories)
autohand --add-dir /path/to/shared-lib --unrestricted

Interaktív parancs

/add-dir használata interaktív munkamenet során:

/add-dir              # Show current directories
/add-dir /path/to/dir # Add a new directory

Biztonsági korlátozások

A következő könyvtárak nem adhatók hozzá:

Saját könyvtár (~ vagy $HOME)
Gyökérkönyvtár (/)
Rendszerkönyvtárak (/etc, /var, /usr, /bin, /sbin)
Windows rendszerkönyvtárak (C:\Windows, C:\Program Files)
Windows felhasználói könyvtárak (C:\Users\username)
WSL Windows-csatlakozások (/mnt/c, /mnt/c/Windows)