CLI ცნობარი

aihummer install
aihummer status

# მხოლოდ შემოწმება, არსებობს თუ არა უფრო ახალი რელიზი
aihummer update --check

# განახლების გამოყენება
aihummer update

aihummer restart
aihummer logs                 # all services
aihummer logs gateway         # one service
aihummer stop

aihummer doctor

aihummer backup /var/backups/aihummer
aihummer restore /var/backups/aihummer/backup-2026-06-26.tar

aihummer set-password

aihummer license keygen        # generate a signing key
aihummer license sign          # sign a license
aihummer license show          # show the current license

aihummer loadtest

aihummer plugin init <kind>            # scaffold a manifest (connector|service|openapi|mcp)
aihummer plugin validate manifest.json # validate a manifest against the contract
aihummer plugin keygen                 # ed25519 author key (.key + .pub)
aihummer plugin package ./my-plugin    # build a tarball + .sha256
aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz

# Publish: privately (to your instance) or publicly (PR to the catalog)
aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz
aihummer plugin publish --public --dir ./my-plugin --key author.key \
  --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \
  --description "..." --icon https://you.example/icon.svg

ბრძანების ხაზის ხელსაწყო `aihummer` მართავს ჰოსტ-მშობლიურ ინსტალაციას: ის უშვებს და განაახლებს gateway-ს (თავად ინსტალაცია სრულდება პირადი კაბინეტის პერსონალური ბმულით), აკონტროლებს systemd სერვისებს, უშვებს დიაგნოსტიკას, ამუშავებს სარეზერვო ასლებს და ხელს აწერს ლიცენზიებს. ეს გვერდი ჩამოთვლის ყველა ბრძანებას. ## ბრძანებები | ბრძანება | რას აკეთებს | |---|---| | `up` / `install` | უშვებს gateway-ის systemd სერვისს (`systemctl start`). არაფერს აინსტალირებს — ინსტალაციას ასრულებს ინსტალაციის სკრიპტი პერსონალური ბმულით. | | `update [--check]` | განაახლებს უახლეს რელიზამდე; `--check` მხოლოდ აცნობებს, ხელმისაწვდომია თუ არა განახლება. | | `restart` | გადატვირთავს სერვისებს. | | `stop` | აჩერებს სერვისებს. | | `logs [svc]` | აჩვენებს ლოგების ბოლოს; გადაეცი სერვისის სახელი გასაფილტრად. | | `status` | აჩვენებს სერვისების სტატუსს. | | `doctor` | უშვებს დიაგნოსტიკას / ჯანმრთელობის შემოწმებებს. | | `backup [dir]` | ქმნის სარეზერვო ასლს (სურვილისამებრ მიზნობრივ დირექტორიაში). | | `restore <file>` | აღადგენს სარეზერვო ასლის ფაილიდან. | | `uninstall [flags]` | შლის ინსტალაციას (იხ. ფლაგები ქვემოთ). საჭიროებს root-ს — გაუშვით `sudo`-თი. | | `set-password` / `admin-password` | ადგენს ლოკალურ ადმინისტრატორის პაროლს. | | `license {keygen\|sign\|show}` | მართავს ლიცენზიებს (გასაღების გენერაცია, ხელმოწერა, ჩვენება). | | `loadtest` | უშვებს დატვირთვის ტესტს gateway-ის წინააღმდეგ. | | `plugin {init\|validate\|keygen\|package\|sign\|publish}` | Plugin SDK: დახარაჩება, ვალიდაცია, გასაღებები, შეფუთვა, ხელმოწერა და გამოქვეყნება (კერძო/საჯარო). | | `version` | ბეჭდავს ვერსიას. | | `help` | აჩვენებს დახმარებას. | ### `uninstall` ფლაგები | ფლაგი | ეფექტი | |---|---| | `--purge` | ასევე შლის მონაცემებს (სრული წაშლა). | | `--yes` | გამოტოვებს დადასტურების მოთხოვნას. | | `--no-backup` | წაშლამდე არ აკეთებს სარეზერვო ასლს. | | `--backup-dir <dir>` | წერს დე-ინსტალაციამდელ სარეზერვო ასლს ამ დირექტორიაში. | ## გამოყენების მაგალითები ### ინსტალაცია და ამუშავება ინსტალაციას ასრულებს პერსონალური ბმული პირადი კაბინეტიდან (იხ. [ინსტალაცია](/ka/v1.0/getting-started/installation)); მის შემდეგ CLI უშვებს და ამოწმებს სერვისს: ```bash aihummer install aihummer status ``` ### განახლება ```bash # მხოლოდ შემოწმება, არსებობს თუ არა უფრო ახალი რელიზი aihummer update --check # განახლების გამოყენება aihummer update ``` ### სერვისების მართვა და ლოგები ```bash aihummer restart aihummer logs # all services aihummer logs gateway # one service aihummer stop ``` ### დიაგნოსტიკა ```bash aihummer doctor ``` ### სარეზერვო ასლი და აღდგენა ```bash aihummer backup /var/backups/aihummer aihummer restore /var/backups/aihummer/backup-2026-06-26.tar ``` > [!TIP] > Postgres არის ჭეშმარიტების წყარო, მაგრამ შენი `AIHUMMER_MASTER_KEY` და blob > დირექტორია ცალკე უნდა იყოს დარეზერვებული — მთავარი გასაღების გარეშე დაშიფრული > საიდუმლოები ვერ აღდგება. ### ადმინისტრატორის პაროლის დაყენება ```bash aihummer set-password ``` ### ლიცენზიები ```bash aihummer license keygen # generate a signing key aihummer license sign # sign a license aihummer license show # show the current license ``` ### დატვირთვის ტესტი ```bash aihummer loadtest ``` ### დანამატები ```bash aihummer plugin init <kind> # scaffold a manifest (connector|service|openapi|mcp) aihummer plugin validate manifest.json # validate a manifest against the contract aihummer plugin keygen # ed25519 author key (.key + .pub) aihummer plugin package ./my-plugin # build a tarball + .sha256 aihummer plugin sign --key author.key --manifest ./my-plugin/manifest.json my-plugin-1.0.0.tar.gz # Publish: privately (to your instance) or publicly (PR to the catalog) aihummer plugin publish --private --instance https://host --token <admin> my-plugin-1.0.0.tar.gz aihummer plugin publish --public --dir ./my-plugin --key author.key \ --artifact-url https://you.example/my-plugin-1.0.0.tar.gz --publisher you \ --description "..." --icon https://you.example/icon.svg ``` სრული SDK-სა და ორივე გამოქვეყნების რეჟიმისთვის იხ. [Plugin SDK](/ka/v1.0/marketplace/sdk) და [დანამატის გამოქვეყნება](/ka/v1.0/marketplace/publishing). > [!WARNING] > `uninstall` საჭიროებს root-ს: გაუშვით `sudo aihummer uninstall`. ხოლო > `sudo aihummer uninstall --purge --yes` შლის მონაცემებს და გამოტოვებს > დადასტურების მოთხოვნას — ჯერ დარწმუნდი, რომ გაქვს გადამოწმებული სარეზერვო > ასლი. ## სად შემდეგ - დააკონფიგურირე, რას აყენებს CLI: [გარემოს ცვლადები](/ka/v1.0/reference/env-vars). - გადაწყვიტე, რომელი ხელსაწყოები შეუძლია გამოიყენოს აგენტმა: [ხელსაწყოების კატალოგი](/ka/v1.0/reference/tools-catalog).