16.1 La agento ¶

Agento estas AI, kiu faras aferojn, ne nur parolas pri ili. Claude Code legas dosierojn, lanĉas komandojn kaj redaktas viajn agordojn, kaj ĝi scias, kiel Vikix estas konstruita, do vi povas peti ŝanĝon per simplaj vortoj.

• Lanĉo
• Kion demandi
• Kiel ĝi scias, kion fari
• Reversaligo de ŝanĝo
• Alia agento
• Kelkaj samtempe

:: snapshot 99e03a6: before an agent session (claude)
:: to see what the agent changed: vikix changes    to take it back: vikix undo

vikix changes      # what the agent changed in your files
vikix undo         # put them back as they were before it started
vikix undo         # again: take the undo back
vikix history      # every snapshot, newest first

vikix agent --list                # which are installed, and which Super+a starts
vikix agent --use opencode        # try one: it offers to install it first
vikix agent --default opencode    # make Super+a start it
vikix agent --default claude      # back to Claude Code
vikix add codex                   # or install one as a feature (vikix remove codex takes it away)

16.2 Transdonoj de Grok Bot ¶

Donu al Grok Bot esplorkonsignon kaj konservu ĝian respondon en Vikix por revizio. vikix grok tenas lokan vican taskon: vi elektas konsignon, algluas la prompton de la tasko en Grok Bot, kaj aprobas ĝiajn lokajn komandojn por kolekti la konsignon kaj redoni rezulton. Grok Bot devas esti instalata kaj enlogita aparte. Konservu ĝian agordon Ekzekuto sur Loka Komputilo ĉe Demandu ĉiun fojon.

Malfermu ĝin de Super+m → AI → Grok Bot: malfermu (montrita kiam ~/.local/bin/grok-bot estas instalita). La najbara Grok Bot: listi taskojn malfermas la vicon en terminalo.

Komencu kun tekstdosiero, kiu enhavas la taskon, la fontojn, kiujn ĝi povas uzi, kaj kion utila respondo devus inkludi. Ekzemple, brief.txt povus peti komparon de du bibliotekoj uzante ilian publikan dokumentaron. Tiam, en via terminalo:

task=$(vikix grok new "Compare the libraries" --brief brief.txt --project vikix)
vikix grok prompt "$task"

Kopiu la afiŝitan mesaĝon al la Grok-roboto. Krei taskon ne sendas ion; kiam Grok ekzekutas vikix grok claim ID sur via loka komputilo, la aprobitita komando donas al ĝi la elektitan priskribon kaj markas la taskon kiel "ekzekutata". La projekta nomo estas etikedo por viaj notoj, ne permeso legi la dosierojn de tiu projekto. --brief - legas la priskribon de la norma eniro anstataŭ de dosiero.

La mesaĝo klarigas, kiel sendi la respondon per vikix grok result ID --file -. La respondo estas JSON kun ĝuste kvar kampoj:

{
  "summary": "The findings, including anything needed to assess them.",
  "sources": [],
  "artifacts": [],
  "questions": []
}

summary estas teksto; la aliaj kampoj estas listoj de tekstaj ŝnuroj. Fontoj kaj artefaktoj estas HTTP aŭ HTTPS-ligiloj, kiuj ne enhavas enmetitajn kredencialojn. Metu la rezultojn en la resumon, tiel ke la respondo ne dependas de dosiero en la nuba komputilo de Grok. Ligiloj estas opciaj; Vikix ne alprenas aŭ plenumas ilin. vikix grok instructions elprintas la kompletan liston de instrukcioj.

Kiam la respondo alvenas, la tasko eniras staton review (revizio) kaj Vikix sendas mesaĝon al la labortablo. Reviziu ĝin en via terminalo:

vikix grok list --state review
vikix grok show "$task"
vikix grok accept "$task"

Se vi malfermis novan terminalon, anstataŭigu "$task" per la ID el list. Akceptante registrojn, pri kiuj vi kontrolis la respondon; ĝi ne aplikas kodon, elŝutas dosierojn aŭ startas alian agenton. Vi povas doni la kontrolitajn rezultojn al laboranto ĉe la komputilo por plua laboro.

Se Grok ne povas fini, ĝi registras la kialon per vikix grok fail ID 'reason'; show konservas la mallongan resumon, la kialon kaj la historion legeblaj. Kreu novan taskon por refari ĝin. Por retiri taskon, uzu vikix grok cancel ID. Retiro fermas la lokan registron; ĝi ne haltigas laboron, kiu jam funkcias en Grok Bot. Sendi la saman rezulton denove estas sekura, sed malsama rezulto ne povas anstataŭigi jam liveritan rezulton.

vikix grok status montras, ĉu grok-bot estas en via komanda vojo, la lokon de la vico kaj la nombrojn laŭ stato. Ĝi ne testas vian konton aŭ la konekton al via komputilo. Ĉi tiu ponto uzas aprobitajn lokajn komandojn, sen fora taska API aŭ oficeja laboranto. Ĝiaj instrukcioj difinas la gamon de la transdono; ili ne izolas la aliajn lokajn komandojn de Grok.

Por la interesatoj: la vico estas privata datbazo SQLite ĉe ~/.local/share/vikix/grok/tasks.db kiel defaŭlto (XDG_DATA_HOME ŝanĝas la bazan datumlokon; VIKIX_GROK_DIR elektas la vican dosierujon rekte). list --json kaj show ID --json provizas strukturigitajn registrojn por viaj propraj iloj. Asertoj estas atomaj, do du Bot-oj ne povas samtempe aserti la saman vican taskon.

16.3 API-ŝlosiloj ¶

Programoj trovas API-ŝlosilon en variablo kiel ANTHROPIC_API_KEY. Ne metu ĝin en ~/.bashrc: tiu dosiero konservas ĉiun version por ĉiam. Vikix havas sekuran lokon:

vikix ai key set anthropic     # paste the key; it isn't shown
vikix ai key list              # the names, and a short fingerprint, never the key
vikix ai key remove anthropic

Aliaj nomoj ankaŭ funkcias: openai, gemini, openrouter, mistral, groq, github, kaj pli (vikix ai help listigas ilin).

• Ĉiu nova terminalo ricevas la ŝlosilon de tiu momento. Terminalo, kiu jam estis malfermita, ricevas ĝin post exec bash; programoj, kiujn la labortablo startigas, ricevas ĝin ĉe la sekva ensaluto.
• Super+a ne uzas ĝin. La agentejo uzas vian Claude-ensaluton kaj planon, ne la ŝlosilon, do vi ne estos fakturita dufoje. Por fakturi la agentejon per la ŝlosilo anstataŭe: VIKIX_AGENT_API_KEY=1 vikix agent.
• Neniam tajpu ŝlosilon en la komanda linio (vikix ai key set sk-ant-...): ĝi restus en la historio de via ŝelo. set rifuzas ĝin kaj diras al vi, kiel forigi ĝin.
• vikix doctor serĉas ŝlosilojn lasitajn en la malĝusta loko, kiel ~/.bashrc, kaj diras, kiel movi ilin.

La ŝlosiloj estas konservitaj en ~/.config/vikix/secrets/, kiun nur vi povas legi. La LEGMI-DOSIERO enhavas la detalojn.

16.4 Lokaj modeloj ¶

Loka modelo funkcias sur ĉi tiu laptopo: neniu konto, neniu kosto, kaj nenio forlasas la maŝinon. Ĝi estas pli malgranda kaj pli malrapida ol Claude, sed bona por demandoj, skribado kaj etaj pecoj de kodo, kaj ĝi funkcias senrete.

• Akirado de modelo
• Parolante kun ĝi
• Kontroli la staton

vikix ai setup       # once: installs Ollama, about 100 MB, no password needed
vikix ai models      # choose a model to download

vikix ai chat        # talk to it; /bye or Ctrl+D leaves

vikix ai status      # running? which model is loaded, and for how long
vikix ai list        # the models you have
vikix ai remove llama3.2:3b
vikix ai restart     # start Ollama again (after changing graphics= in ~/.config/vikix/ai)
vikix ai uninstall   # take Ollama away (add --models to delete the models too)

16.5 Tradukado de la gvidiloj al Esperanto ¶

La elŝutita dosieraro inkluzivas translate-guides-to-epo.sh, apartan Bash/Python 3-skripton, kiu sendas la Markdown-dosierojn en docs/ al via loka Ollama-modelo. El la elŝutita dosieraro, antaŭrigardu la dosierojn, kaj poste traduku:

./translate-guides-to-epo.sh --dry-run
./translate-guides-to-epo.sh

Ollama jam devas esti lanĉita kaj la modelo instalita. La defolta modelo estas translategemma:27b (aŭ la eksportita OLLAMA_MODEL); la defolta servilo estas http://127.0.0.1:11434. Nenio estas aŭtomate elŝutata. La rezulto estas konservata en ~/vikix-guides-eo, ekster la ĉefkopiaĵa dosierujo, kun la samaj relativaj dosiernomoj. Ekzistantaj tradukoj estas preterlasataj, do interrompita procezo povas rekomenci; uzu --overwrite por traduki ilin denove. --source, --output, --host kaj --timeout anstataŭigas tiujn agordojn; --help listigas la opciojn. Konservu la fontajn kaj rezultajn dosierujojn aparte. Petoj al TranslateGemma inkluzivas la fontan anglan (en) kaj celan esperantan (eo) en la peto, laŭ la modelo-petformato.

Fiaskinta peto haltigas la skripton kun eraro kaj konservas la antaŭan rezulton por tiu dosiero. Grandaj dokumentoj estas disigitaj en tekstaj eroj de maksimumo 12000 karakteroj ĉe blankaj linioj (aŭ liniaj limoj en longaj alineoj), kun 32k konteksto kaj HTTP-tempolimo de 1800 sekundoj por peto. Kodaj eroj estas kopiataj rekte, sen sendi ilin al la modelo. Ununura proza linio pli granda ol la er-limo devas esti dividata mane. Ĉiu dosiero estas konservata nur post kiam ĉiuj ĝiaj eroj sukcesas. Krudaj modelaj respondoj kun argumentaj kanaloj aŭ prefikso <think> estas reduktitaj al la fina respondo; mankantaj aŭ malplenaj finaj respondoj haltigas la procezon. Se antaŭa traduko enhavas tiujn argumentajn markilojn, normala rekomencita procezo raportas ĝin anstataŭ preterlasi ĝin: uzu --overwrite por regeneri ĝin. Revizu la rezulton: la modela rezulto povas ŝanĝi komandojn, formatigon aŭ signifon spite al la peto. Ĉi tio produktas Markdown-kopiojn; ĝi ne rekonstruas la retumilon aŭ la gvidilojn de Info.

16.6 llm en la komandlinio ¶

llm sendas tekston al modelo kaj elprintas la respondon, do ĝi taŭgas en kaskado kun aliaj komandoj. La sama komando funkcias kun loka modelo kaj kun Claude.

vikix ai llm                               # once: install it (or vikix add llm)
cat notes.md | llm "summarise this"
git diff | llm "write the commit message"
llm "what does chmod 750 mean?"
llm -m llama3.2:3b "..."                   # a local model, by name
llm -m claude-sonnet-5 "..."               # Claude, with your API key

Ĝia defaŭlta modelo estas loka, se vi havas lokalan modelon, altrimenti Claude, se vi agordis ŝlosilon de Anthropic. Por elekti: vikix ai llm --default MODEL.

Ĉio, kion vi demandas, estas registrita: llm logs -n 5 montras la lastajn kvin, kaj llm logs off haltigas la registradon.

16.7 Demandado de viaj notoj: note ¶

note respondas al demandoj el dosierujo de Markdown, ekzemple, Obsidian-depoteto, en ajna terminalo. vikix add notes instalis ĝin (kaj lokan AI, kiun ĝi bezonas), poste:

note index ~/General --skip Admin,Readwise   # the first time: about five minutes a thousand notes
note ask "what did I write about runit?"     # the answer, and the notes it came from
note index                                   # after changes, from anywhere: only what changed

note find "..." listigas la plej proksimajn notojn sen respondo, kaj note status montras la dosierujon, la indekson kaj kiu respondas.

Ĝi funkcias en du paŝoj. note index disigas ĉiun noton en partojn ĉe ĝiaj titoloj kaj transformas ĉiun en enmeton, liston de nombroj reprezentantaj ĝian signifon, kun eta modelo sur la portebla komputilo. note ask faras la saman kun la demando, prenas la ses plej proksimajn partojn kaj generas modelan respondon nur el ili, indikante la notojn. La listo de notoj, kiu estas presita sub ĉiu respondo, permesas kontroli ĝin: eta loka modelo foje respondas el la malĝusta noto.

Kiu respondas sekvas Super+i (vikix ai use local aŭ claude); note ask --claude aŭ --local elektas por unu demando. Loke, nenio forlasas la porteblan komputilon. Kun Claude, la ses trovitaj partoj, neniam la tuta dosierujo, estas sendataj al Anthropic, kaj la respondoj estas multe pli bonaj. Dosierujojn, kiujn vi neniam sendus ie ajn, forlasu kun --skip: ili eĉ ne estos legataj. Kaŝitaj dosieroj kaj dosierujoj (.obsidian, la .#note.md, kiun Emacs lasas dum noto ne estas konservata) ankaŭ ne estos uzataj.

Viaj elektoj estas en ~/.config/vikix/notes: folder=, skip=, kaj embed=, la modelo por enmetoj. nomic-embed-text (post ollama pull nomic-embed-text) trovas pli bonajn partojn ol all-minilm, sed estas pli malrapida; ŝanĝi ĝin signifas, ke ĉiu noto estos denove legata. La indekso estas ~/.local/share/vikix/notes/index.db, en dosierujo, kiun nur vi povas legi; vikix notes uninstall --index forigas ĝin.

16.8 Viaj propraj programoj: ~/dev/ai ¶

Por vidi, kiel la resto funkcias, aŭ por konstrui ion propran, ~/dev/ai enhavas kvar etajn programojn, kiujn vi povas legi, uzi kaj modifi. Ĉiu havas README kaj make run:

claude

Kion ĝi montras: Unu demando al Claude: ask.py kun la Python-biblioteko de Anthropic, ask.sh kun curl kaj jq, unu HTTP-peto
Kion ĝi bezonas: Klavo de Anthropic (vikix ai key set anthropic)

local

Kion ĝi montras: La sama demando al modelo sur la portebla komputilo, per la API de Ollama
Kion ĝi bezonas: vikix add local-ai kaj modelo

embeddings

Kion ĝi montras: Propoziĵoj transformitaj en nombrojn, konservitaj en SQLite (sqlite-vec), la plej proksimaj al demando laŭ signifo
Kion ĝi bezonas: Ollama, kaj make setup (all-minilm, 46 MB)

ask-notes

Kion ĝi montras: Dosierujo de Markdown-notoj, serĉataj kaj respondatitaj
Kion ĝi bezonas: La sama, kaj modelo por respondi (aŭ klavo)

ask-notes estas note reduktita, por legi kaj modifi; por ĉiutaga uzo, note estas la ĉefa. Ĝi funkcias ankaŭ kun viaj propraj notoj:

cd ~/dev/ai/examples/ask-notes
make setup                                          # once
make index NOTES=~/General SKIP=Admin,Readwise      # about five minutes a thousand notes; later, only what changed
make ask QUESTION="What did I write about runit?"   # the local model answers, naming the notes
make ask QUESTION="..." CLAUDE=1                    # Claude answers: those six passages go to Anthropic

La indekso, notes.db, restas en tiu dosierujo kaj enhavas fragmentojn el viaj notoj: make clean forigas ĝin. Kaŝitaj dosieroj kaj dosierujoj (.obsidian, la .#note.md, kiun Emacs lasas dum noto ne estas konservita) neniam estas legataj, kaj SKIP forigas tiujn, kiujn vi neniam sendus ie ajn.

La malgrandaj modeloj estas rapidaj, sed preterlasas aferojn: all-minilm foje rangigas la malĝustan noton unue, kaj modelo de 3 gigaojto respondas bazante sin sur ĉio, kio estas donata al ĝi. Ĉiu respondo listigas la notojn, kiuj estis donataj al ĝi, do vi povas kontroli. EMBED_MODEL=nomic-embed-text (post ollama pull nomic-embed-text, poste reindeksu) trovas pli bonajn fragmentojn, kaj CLAUDE=1 donas pli bonajn respondojn.

La Python-skriptoj nomas siajn bibliotekojn ĉe la supro, fiksante ilin (# /// script), kaj uv run alportas ilin la unua fojo, do nenio estas instalata por la tuta maŝino.

16.9 AI sur la elektita teksto ¶

Elektu iun tekstfragmenton ie ajn, en retejo, retpoŝto, terminalo, kaj premu Super+i. Menuo demandas, kion fari kun ĝi:

Demandu pri ĝi

Tipe demandon pri la teksto (aŭ elektu nenion, kaj demandu ion ajn)

Korektu

La tekston kun ĝiaj eraroj korektitaj, en la interŝanĝilo

Reskribu: pli klara

La sama afero dirita pli klare, en la interŝanĝilo

Traduku

En la lingvon, kiun vi elektas, en la interŝanĝilo

Klarigu

Kion ĝi signifas; por eraromesaĝo, kiel korekti ĝin

Kio estas metita en la interŝanĝilon ankaŭ estas montrita en notifo; algluu ĝin, kie vi volas. Korektu ankaŭ listigas, kion ĝi ŝanĝis: malgrandaj modeloj foje "korektas" tion, kio estis ĝusta. Mallonga respondo aperas kiel notifo, pli longa en terminalo (q fermas ĝin). La teksto estas tio, kion vi lastfoje markis, eĉ se ĝi ne plu estas markita sur la ekrano; nur kiam ne estas teksto, ĝi uzas tion, kion vi kopiis. La notifo, dum ĝi funkcias, montras la komencoon de la teksto, kiun ĝi prenintis.

Ĝi bezonas llm (vikix ai llm) kaj lokan modelon. Malgranda modelo prenas kelkajn sekundojn: ĉirkaŭ 10 sekundojn por frazo, por korekti aŭ klarigi.

• Loka aŭ Claude
• Codex

use=local          # free, offline, the text stays on this laptop
model=             # empty: llama3.2:3b, or your first local model
languages=English Esperanto French Spanish Arabic Hindi

use=codex
model=gpt-6-luna   # Codex's /model lists them
effort=low         # low, medium or high; empty: Codex's own setting

16.10 AI en Neovim ¶

La Neovim de Vikix havas CodeCompanion, sub Space A:

Space A c

Ĉato apud via kodo, sur la modelo, kiun Super+i uzas: lokala modelo, aŭ Claude

Space A q

Petu informojn pri la elekto (aŭ la dosiero), aŭ petu ŝanĝon al ĝi

Space A a

Aldonu la elekton al la ĉato

Space A g

Ĉato kun via agento (la agento, kiun Super+a startas), kiu povas legi kaj ŝanĝi viajn dosierojn

Space A t

Via agento en terminalo ene de Neovim

Space A p

Ĉio alia, kion CodeCompanion faras

La ĉato sekvas vikix ai use: local (modelo sur ĉi tiu komputilo, unue vikix ai setup) aŭ claude (via ŝlosilo: vikix ai key set anthropic). Modelo fiksita per model= en ~/.config/vikix/ai ankaŭ estas uzata ĉi tie. Sur la CPU de komputilo, la unua respondo de lokala modelo prenas minutojn, ĉar ĝi unue legas la instrukciojn de CodeCompanion; Claude respondas en sekundoj. La supra linio de la ĉato diras, kiu respondas, antaŭ ol vi tajpas: la modelo, kaj ĉu ĝi estas sur ĉi tiu komputilo aŭ sendita al Anthropic (aŭ kiu agento). En la ĉato, ga ŝanĝas la modelon aŭ la agenton por tiu ĉato.

La agento en Space A g estas startita per vikix agent --acp, do ĝi estas la sama kiel tiu de Super+a: la gvidilo, sen API-ŝlosiloj, kaj unue estas kreita kopio, do vikix changes montras, kion ĝi faris, kaj vikix undo malfaros tion. Ĝi ensalutas kun sia propra uzantonomo, tiu, kiun ĝi uzas en terminalo. Claude Code kaj Codex bezonas sian adaptilon, kiun vikix agent --install claude aldonas (se vi faras ĝin denove por agento, kiun vi jam havas, ĝi nur aldonas tion, kio mankas). Space A t efektive faras vikix agent, do Aider ankaŭ funkcios tie.

Nenio komenciĝas aŭ konektiĝas ĝis vi premas klavon. Kiam io mankas (ŝlosilo, Ollama, la agento aŭ ĝia adaptilo), la klavo diras, kion tajpi, kaj nenion alian.

16.11 AI en Emacs ¶

La konfiguracio de Emacs havas gptel por la ĉato kaj agent-shell por via agento, kaj Vikix agordas ambaŭ:

C-c g

Ĉato, sur la modelo, kiun Super+i uzas: lokala modelo, aŭ Claude. Kun elekto, la ĉato komenciĝas de ĝi

C-c G

La menuo de gptel: alia modelo por ĉi tiu ĉato, kaj kion sendi. Claude kaj viaj lokaj modeloj aperas unue; unu el la propraj modeloj de la konfiguracio (OpenAI, Perplexity) aperas nur se ĝia ŝlosilo estas tie

C-c a

Ĉato kun via agento (la agento, kiun Super+a startas), kiu povas legi kaj ŝanĝi viajn dosierojn. Ĝi revenas al la ĉato de ĉi tiu projekto, se ekzistas; de dosierujo, kie ne ekzistas, ĝi petas (New shell komencas ĉato tie; la aliaj iras al ĉato en alia dosierujo). C-u C-c a ĉiam komencas novan

C-c A

Via agento en terminalo ene de Emacs

La ĉato sekvas vikix ai use kaj model=, kiel ĉe Neovim, kaj Emacs re-legas ilin ĉe ĉiu C-c g, do ŝanĝo atingas Emacson, kiu jam estas malfermita. Modelo, kiun vi elektas en la menuo, restas ĝis vi ŝanĝas tiun dosieron. La agento startas per vikix agent --acp, kun la samaj reguloj kiel en Neovim, supre; C-c A efektive faras vikix agent, do Aider funkcios tie ankaŭ. Kiam io mankas, la klavo diras, kion tajpi. Neovim kaj Emacs komparas la du.

16.12 La labortablo kiel iloj (MCP) ¶

MCP estas kiel AI-agento ricevas siajn proprajn ilojn. vikix mcp register donas al via agento fiksitan aro da iloj por ĉi tiu labortablo, do ĝi povas rigardi ĝin kaj fari malgrandajn ŝanĝojn sen skribi komandojn.

Kial, kiam la agento ja povas ekzekuti komandojn? Ĉiu komando bezonas vian akcepton. Ĉi tiuj iloj estas malmultaj, kontrolitaj kaj facile malreversigeblaj, do vi povas permesi ilin unufoje: en Claude Code, respondu "permesi ĉiam" por vikix-ilo (aŭ permesi mcp__vikix__*). Tiam la agento rigardas la labortablon kaj ŝanĝas temon aŭ fenestron sen peti ĉiufoje, dum ĉiu alia komando ankoraŭ petas.

vikix mcp register     # for Claude Code and Antigravity CLI, then restart them; it prints the lines for Codex, Gemini CLI and OpenCode
vikix mcp status       # is it on, with which tools, the servers running (and their version), the last calls
vikix mcp tools        # what it offers
vikix mcp unregister   # take it away

desktop

La labortaboj kaj iliaj fenestroj (ankaŭ la kolumnoj de baraĵo, en ordo), la ekranoj, la temo

keys

Ĉiu klavo, kiun Vikix ligas, kaj kion ĝi faras

rules

La reguloj de la labortablo (ĉiu numero, ŝaltita aŭ malŝaltita, kie ĝi estas skribita, kiel ofte ĝi ekzekutiĝis), kaj por fenestro, kiun vi nomas, kiuj reguloj aplikiĝis al ĝi kaj kiuj kongruas kun ĝi sed ne aplikiĝis. Nenio estas ŝanĝita aŭ ekzekutita

why

Kion la labortablo faris lastatempe kaj kio kaŭzis tion: klavo kaj ĝia komando, regulo kaj ĝia fenestro, la menuo, agento; ĉiu kun la loko, kie ĝi estas skribita. Por "kial mia fenestro moviĝis?"

agents

La agentoj, kiuj funkcias en la labortablo, la agento, kiu demandadas inter ili: la dosierujo, branĉo, nekomunikitaj dosieroj, labortaboj de ĉiu, dum kiom da tempo, kaj kion ĝi faras. Tiel, agento povas vidi, ke alia agento funkcias en dosierujo antaŭ ol ĝi ŝanĝas dosierojn tie

handoff, handoff_update

Legas aŭ ĝisdatigas la datumojn pri transdono de la labortablo: tasko, stato, resumeto, sekva, kontrolas per freŝeco, sesioj

doctor, history, changes, themes, version

Kion diras vikix doctor, vikix history, vikix changes, vikix theme kaj vikix version

docs_search, docs_read

Trovas kaj legas la dokumentojn en ĉi tiu maŝino, tiujn, kiujn Super+F2 serĉas: ĉi tiuj gvidiloj, manpaĝoj, la dokumentoj kaj PDF-aj dosieroj de viaj projektoj, viaj notoj, la eniroj de la dokumentaroj de Zeal; kiel ligilo al la interreto, estas donita nur ĝia adreso, neniam ĝi estas ŝarĝata. Tiel, la agento povas respondi de la manpaĝo, ne de la memoro. Viaj propraj dokumentoj (own= en ~/.config/vikix/docs) restas fermitaj por ĝi, kiel ankaŭ por vikix docs ask, ekzekutita de agento, krom se linio agents= malfermas dosierujon

records_search, records_get

Trovas kaj legas, kion viaj kromprogramoj konservas (vikix records): flugaj serĉoj, kunvenoj, la uzo de via plano de Claude. Ĝi ne povas aldoni aŭ ŝanĝi datumon

file_changes

Ĉiu ŝanĝo farita al viaj dosieroj per Esploro (vikix add esploro), la plej novaj unue, en vortoj, kaj ĉu ĝi estis forigita. Por "kie tiu dosiero iris?". Ĉi tie nenio estas forigita: tio restas via, en Esploro, Redakti → Ŝanĝoj…

notify

Montras sciigon, markitan kiel apartenan al la agento

snapshot

Registras viajn agordojn antaŭ ŝanĝo

set_theme, switch_workspace, focus_window

Malgrandaj ŝanĝoj, facile forigeblaj

commands

La komandoj de la labortablo, kiujn la agento povas ekzekuti per sia nomo: ŝanĝoj kaj movoj estas rekreitaj tiel facile kiel faritaj (ne ĝenu, nokta lumo, interspacoj, titolaj vidoj, fokuso maldekstre...)

run_command

Ekzekutas unu el tiuj, kiel farus ĝia klavo. La labortablo rifuzas ajnan alian komandon, kaj diras kial

propose_file_changes

Proponas planon de ŝanĝoj al viaj dosieroj (kopiu, movu, renomu, novaj dosierujoj, la rubujo, etikedoj), kiu atendas vin: unue kontrolite, poste montrita en Esploro kun kialo, kie nur via Apliki ekzekutas ĝin, kaj forigo reigas ĝin. Sen Esploro, ne estas loko por montri ĝin, kaj la ilo diras tion

propose_rule

Proponas regulon por la labortablo, kiu atendas vin: unue kontrolita por esti nur regulo (verboj kaj simplaj valoroj, ne Lisp de si mem), poste montrita sub Super+m → Reguloj, kie vi aldonas ĝin al via rules.lisp aŭ forlasas ĝin (Reguloj)

Du plu estas neaktivigitaj, krom se vi aktivigas ilin, ĉar ili povas multe ŝanĝi: vikix mcp register --allow-eval aldonas eval (Lisp en la fenestradministrilo, tra la pordo, sube) kaj cuis_eval (Smalltalk en la Cuis-bildo, tra la propra esplorilo de la bildo, sube) kaj --allow-undo aldonas undo (viaj agordoj reen al unu antaŭa stato). vikix mcp register denove, sen ili, forigas ilin. Ili estas komforto, ne ŝloso: agento, kiu povas ekzekuti komandojn, povus ekzekuti vikix eval mem, kaj tio ankaŭ pasas tra la pordo.

• La pordo

vikix door                 # what waits: when, which agent, why, the form
vikix door run 1           # run it, as you
vikix door drop 1          # forget it
vikix door check '(form)'  # would it pass? "ok", or why not
vikix door allowed         # every name a form may call

16.13 Diktaĵo ¶

Premu Super+F9 kaj parolu. Premu Super+F9 denove, kaj post momento, kion vi diris estas enmetita en la fenestron, en kiu vi estis: du aŭ tri sekundoj por frazo, proksimume dek sekundoj por minuto da parolo. Ĝi ankaŭ estas metita en la interŝanĝon, se tiu fenestro ne akceptis ĝin. Se vi moviĝas al alia fenestro dum ĝi estas skribata, ĝi ne estas enmetita tie: ĝi estas nur metita en la interŝanĝon, kaj notifo diras tion. Super+Shift+F9 haltigas sen enmeti ion. Dum ĝi aŭskultas, la baro montras mic, en ruĝo.

Ĝi estas premado, parolo, premado: StumpWM vidas, ke klavo estas premita, ne levita, do teni la klavon dum vi parolas ne estas ebla (repetoj de tenita klavo estas kalkataj kiel unu premado).

Ĝi aŭskultas maksimume kvin minutojn. Tiam ĝi haltas, diras tion, kaj la sekva Super+F9 enmetas tion, kion ĝi aŭdis. Post ĉiu diktaĵo aperas spaco, do la sekva ne kunigas kun ĝi.

Por agordi ĝin, unufoje (kelkaj minutoj, sen pasvorto):

vikix add dictation          # or: vikix dictate setup

Tio kompilas whisper.cpp por ĉi tiu komputilo, en la dosierujon ~/.local/opt/whisper.cpp, kaj elŝutas ĝian modelon (150 MB) kaj voĉ-detektilon (1 MB) en la dosierujon ~/.local/share/vikix/whisper/, ĉiu el ili estas kontrolata kontraŭ ĝia publikigita kontrolsumo. Ĉio funkcias sur la portebla komputilo: via voĉo neniam forlasas ĝin, kaj la registrado estas forigita post kiam ĝi estas skribita.

Angla, aŭ multaj lingvoj. La modelo, kun kiu ĝi komencas, base.en, konas nur la anglan, kaj skribas frazon en ĉirkaŭ unu sekundo. small konas multajn lingvojn (franĉa, hispana, araba, hindia kaj aliaj; ne Esperanto) kaj bezonas kelkajn sekundojn:

vikix dictate models          # which is used
vikix dictate models small    # many languages (490 MB)
vikix dictate models base.en  # back to English

Silento kaj bruo ne estas tajpitaj. La detektilo de voĉo transdonas nur paroladon al la programo "whisper", kaj la notoj de "whisper" pri sonoj, kiel "(muziko)", estas forlasataj: ĉio, kion ĝi skribas en krampoj, estas forigata, do ankaŭ parolita digresio en krampoj estos forigata. Tre mallonga fragmento (unu aŭ du sekundoj) povas aperi kiel vorto aŭ du, kiujn neniu diris.

Kio restas poste: la registrado estas forigata, kiam ĝi estas skribita. La teksto restas tie, kie ĝi estis tajpita, en la interŝimbaŭro (do en sia historio, Super+c), kaj en la notifo "Tajpita" (Super+Shift+n montras la pli malnovajn).

vikix dictate status diras, ĉu ĝi estas agordita, kaj kun kiu modelo. vikix dictate file talk.wav elprintas, kion registrado, kiun vi jam havas, diras, sen tajpi ĝin ie ajn.

Por forigi ĝin: vikix remove dictation (la modeloj restas; vikix dictate uninstall --models forigas ilin ankaŭ).

16.14 Parolado kun la AI ¶

Dikta programo tajpas kion vi diras. Voĉo sendas ĝin al la AI anstataŭe, kaj la respondo revenas laŭte.

Super+F10, parolu, Super+F10

La ĉata modelo respondas: tiu, kiun Super+i uzas (loka, Claude aŭ Codex, kiu prenas ĉiu demandon aparte). Vi aŭdas la respondon kaj vidas ĝin en notifo (longa notifo aperas en terminalo)

Super+F11, parolu, Super+F11

Ĝi iras al la agento, Claude Code, en sia propra terminalo. La respondoj de Claude estas legataj laŭte

Super+Shift+F10

Halta la paroladon

Ĝi memoras la konversacion. Demandu "Kio estas la ĉefurbo de Francio?", poste "Kaj kiom da homoj loĝas tie?", kaj ĝi scias, ke vi celas Parizon. Post kvin silentaj minutoj la sekva demando komenciĝas freŝe; Super+m → Voĉo: nova konversacio faras tion tuj. Kun la agento, ĉiu demando post la unua iras al la sama terminalo, do ĝi daŭrigas tie ankaŭ; fermu tiun terminalon por komenci denove.

Ĝi haltas la paroladon, kiam vi komencas. Premante Super+F10 aŭ Super+F11 por paroli, ĝi tuj haltas, do la mikrofono ne aŭdas ĝin.

Por agordi ĝin, unufoje (unu minuto, sen pasvorto):

vikix add voice            # brings dictation and llm, if they aren't here

Tio instalas Piper, voĉon, kiu funkcias sur ĉi tiu portebla komputilo, kaj elŝutas voĉon por ĝi (60 MB, kontrolita per ĝia publikigita kontrolsumo).

Kie viaj vortoj iras. La aŭskulto estas diktado: sur ĉi tiu portebla komputilo. Demando al Super+F10 sendas la tekston tien, kie Super+i sendas ĝin (neniel, kun loka modelo; al Anthropic, kun Claude; al OpenAI, kun Codex: vikix ai use). Demando al Super+F11 sendas la tekston al la kompanio de la agento, kiel kun Super+a. La respondo estas prononcata sur ĉi tiu portebla komputilo.

Viaj elektoj troviĝas en ~/.config/vikix/voice:

vikix voice voices          # which voice: lessac, amy (American), alan (British)
vikix voice voices alan     # switch (it downloads the voice)

Meti speak=no tie ĉi, por vidi nur la respondojn, aŭ idle= por ŝanĝi la kvintan minuton. vikix voice say "iu teksto" legas ajnan tekston laŭte.

Nur la respondoj de Claude Code estas legataj laŭte: kun alia agento (vikix agent --default), Super+F11 ankoraŭ sendas vian demandon, kaj la respondo restas sur la ekrano.

Por forigi ĝin: vikix remove voice (la voĉoj restas; vikix voice uninstall --voices forigas ilin ankaŭ).

16.15 Kiam AI ne funkcias ¶

Super+a montras mesaĝon kaj "Eniru fermas ĉiun fenestron"

Ĝi diras, kio mankas: agento por instali, ŝlosilo, loka modelo

Super+a malfermas terminalon, kiu tuj fermiĝas

Rulu vikix agent en terminalo por vidi la mesaĝon

La agento petas, ke vi ensalu ĉiufoje

Rulu claude unufoje en terminalo kaj finu la ensaligon tie

La agento diras, ke ĝi ne povas atingi la labortablon

vikix doctor: ĝi kontrolas, ĉu vikix eval funkcias

Loka modelo ne respondas, aŭ estas malrapida

Vidu Loka AI ne respondas

llm ne havas modelon, petas ŝlosilon, aŭ ne povas konekti

Vidu llm ne respondas

Super+i diras "Super+i bezonas llm", "Ankoraŭ ne ekzistas loka modelo" aŭ "Loka AI ne funkcias"

Faru tion, kion ĝi diras: vikix ai llm, modelo kun Super+m → Loka AI: elektu modelon, aŭ vikix ai setup

Super+i diras "Unue elektu iom da teksto"

Marku la tekston (aŭ kopiu ĝin), poste premu Super+i denove

Super+F9 diras "Dikto ne estas agordita"

vikix add dictation, unufoje

Super+F10 respondas, sed nenio estas aŭdata

vikix voice status; speak=no en ~/.config/vikix/voice malŝaltas la voĉon; kontrolu la volumon kaj la eliron en pavucontrol

"Voĉo ne estas agordita"

vikix add voice, unufoje

Super+F9 diras "Aŭdis nenion"

La mikrofono: pavucontrol, Enigaj aparatoj, kontrolu, ĉu ĝi ne estas mute kaj moviĝas, kiam vi parolas

Super+F9 tajpas en la malĝusta loko

Ĝi tajpas tie, kie estas la fokuso, kiam vi premas la duan Super+F9; la teksto ankaŭ estas en la intertavolo

Super+i diras "AI ankoraŭ laboras pri la lasta"

Atendu ĝian respondon: unu post la alia

Super+i diras "Vi ne havas la modelon..."

vikix ai models akiras ĝin, aŭ lasu model= en ~/.config/vikix/ai malplena

Super+i diras "Claude bezonas vian ŝlosilon de Anthropic"

vikix ai key set anthropic, aŭ reveni al loka: vikix ai use local

Super+i diras "AI ne respondis"

La notifo diras, kial; loka modelo: vikix ai status

Super+i diras "Codex ne estas instalita" aŭ "ne estas ensaligita"

vikix add codex, poste codex login; aŭ reveni al loka: vikix ai use local

Super+i diras, ke io en ~/.config/vikix/ai ŝajnas esti erara

Korektu tiun linion (use=local, use=claude aŭ use=codex; model= nomo el llm models, aŭ unu el Codex; effort= vorto kiel low), aŭ forigu la dosieron: la sekva Super+i skribos ĝin denove

Super+i prenis la malĝustan tekston

Ĝi prenas la lastan markitan tekston, antaŭ la intertavolo: marku la tekston, kiun vi celas

note diras "ankoraŭ ne ekzistas dosierujo" aŭ "ankoraŭ ne ekzistas indekso"

note index ~/Notes unufoje (via dosierujo; --skip A,B forlasas dosierujojn)

note diras, ke la indekso bezonas lokan AI, aŭ ne povas atingi Ollama

La indekso estas kreata sur ĉi tiu laptopo: vikix add local-ai, poste vikix ai status

note ask respondas de la malĝusta notoj

La notoj, kiuj estis donitaj, estas listigitaj sub la respondo. note ask --claude respondas pli bone; embed=nomic-embed-text en ~/.config/vikix/notes trovas pli bonajn fragmentojn (post ollama pull nomic-embed-text; la sekva note index relege ĉiun noton)

La agento ne havas vikix-ilojn

vikix mcp register, poste restartigu la agenton; vikix mcp status diras, ĉu ĝi estas ŝaltita (vidu Kiam io rompiĝas)

Vi ne ŝatas, kion la agento ŝanĝis

vikix changes, poste vikix undo