Add vibekit to algokit cli + implement it to init by p2arthur · Pull Request #716 · algorandfoundation/algokit-cli

p2arthur · 2026-03-13T20:34:39Z

Add algokit vibe spike + init prompt - Builds on top of decoupling branch

Hey! This PR adds a "spike" for VibeKit integration. It’s mostly opt-in for now so it doesn't break anyone's existing workflow.

What I did

New Commands: Added algokit vibe with setup and status subcommands.

setup checks if you have VibeKit, asks to install it if you don't, and then runs init.

status just checks the current VibeKit status.

Init Prompt: I added a prompt to algokit init. Now it asks if you want to set up VibeKit right away inside the new project folder.

Docs & Tests: Added a new docs page and wrote some tests to make sure the commands and the init prompt actually work.

Snapshot Fix: Had to update one init snapshot because of a small git config change.

A few notes

It's still a spike, so I kept everything optional.

I didn't add any automatic .gitignore logic for Vibe files yet—figured I'd keep it simple for this first pass.

I’m passing LocalNet context through env vars, but I made it non-blocking so it won't crash the setup if something is weird.

…ibekit if missing and run it to the generated project

Ganainmtech · 2026-03-16T14:35:11Z

+1, some builders add VibeKit after algokit init (or vice versa), so being able to set it up in one go would improve the agentic dev experience or at least give builders the option while staying inside their AlgoKit project.

aorumbayev · 2026-03-17T17:15:23Z

poetry.lock

this should be removed, decoupling branch is already on uv we likely just forgot to remove the poetry lockfile

aorumbayev

thanks for spiking on this, good initiative on making it opt-in and non-blocking 👍 see inline comments for details — my main suggestion is moving this under algokit task and removing the init integration

aorumbayev · 2026-03-17T17:24:52Z

src/algokit/cli/__init__.py

 from algokit.cli.project.bootstrap import bootstrap_group
 from algokit.cli.project.deploy import deploy_command
 from algokit.cli.task import task_group
+from algokit.cli.vibe import vibe_group


this is the main concern with the pr — vibekit is an external third-party tool that we're wrapping, and we already have an established namespace for exactly this: algokit task. see how ipfs, analyze, wallet etc all live under algokit task as subcommands/subgroups in src/algokit/cli/tasks/. the ipfs subgroup is the closest analogue since it's also a click group with multiple subcommands wrapping an external service.

i'd suggest:

move vibe.py → src/algokit/cli/tasks/vibe.py and register via task_group.add_command(vibe_group) in src/algokit/cli/task.py. user gets algokit task vibe setup / algokit task vibe status

remove the init integration — imho the value of embedding it in init is saving the user from typing algokit task vibe setup after init, but the cost is a new prompt shown to every interactive init user, 25 lines of gating logic with an implicit run_bootstrap coupling, and a broad except Exception in a critical flow. vibekit setup is a post-init task, not a project scaffolding concern — it doesn't belong in the init flow. If you do think its worth keeping then perhaps you can print a informational message that can now invoke this task command to setup vibekit (along with a short sentence on what this tool is and how it relates to algokit)

keeping it as algokit task vibe command group

aorumbayev · 2026-03-17T17:24:52Z

src/algokit/cli/vibe.py

+VIBEKIT_INSTALL_URL = "https://getvibekit.ai/install"
+
+
+@click.group("vibe", short_help="Give your AI assistant Algorand superpowers using VibeKit.")


nit: the marketing copy in the short_help feels a bit out of place compared to other command descriptions in the cli. compare with:

"Collection of useful tasks to help you develop on Algorand." (task)

"Upload files to IPFS using Pinata provider." (ipfs)

"Manage the AlgoKit LocalNet." (localnet)

i'd suggest something more descriptive and consistent like "Install and manage VibeKit for AI-assisted development." — tells the user what it does without the superpowers marketing

aorumbayev · 2026-03-17T17:24:52Z

src/algokit/cli/vibe.py

+    return ["sh", "-c", f"curl -fsSL {VIBEKIT_INSTALL_URL} | sh"]
+
+
+def _build_vibekit_init_env() -> dict[str, str]:


we already have this exact logic in localnet_status at src/algokit/cli/localnet.py:293-301 — it does the same sandbox.ps() → ps_by_name → check state pattern. rather than duplicating it here, i'd suggest extracting a small helper into core/sandbox.py like:

def is_localnet_running() -> bool: """Check if the AlgoKit LocalNet services are running.""" ...

then both localnet status and vibe can reuse it. also note you're only checking ("algod", "indexer") but the canonical service list is SERVICE_NAMES = ("algod", "conduit", "indexer-db", "indexer") defined in localnet.py:276 — worth being consistent there

also the ComposeSandbox import at module level will pull in docker/container engine deps just from importing vibe.py — localnet handles this more carefully. given that localnet context is optional (your docs say vibekit init still runs without it), a lazy import inside the try block would be safer

aorumbayev · 2026-03-17T17:24:52Z

src/algokit/cli/vibe.py

+            )
+    except Exception as ex:
+        # Context injection should never block initialization.
+        logger.warning("Unable to inspect AlgoKit LocalNet status; proceeding without confirmed LocalNet state.")


the warning doesn't tell the user what actually went wrong — could be docker not running, permission denied, network issue etc. at minimum include the exception so the user has something actionable. something like f"Unable to inspect LocalNet status ({ex}); proceeding without confirmed LocalNet state." — we do this in other places in the cli

aorumbayev · 2026-03-17T17:24:52Z

src/algokit/cli/vibe.py

+    """Run VibeKit setup flow."""
+    vibekit_cmd = _resolve_vibekit_command()
+    if vibekit_cmd is None:
+        click.echo(click.style("VibeKit not found.", fg="yellow"))


we generally use logger.warning() for warning-level messages throughout the cli rather than click.echo(click.style(...)) — see how _maybe_bootstrap, localnet commands, codespace etc handle this. using logger ensures consistent formatting with verbose mode and our log handlers

aorumbayev · 2026-03-17T17:24:52Z

src/algokit/cli/init/command.py

-        and git("commit", "-m", commit_message, bad_exit_warn_message="Initial commit failed")
+        and git(
+            "-c",
+            "commit.gpgsign=false",


should this be done in a separate pr?

aorumbayev

see comments above

p2arthur added 3 commits March 13, 2026 13:28

feat: add algokit vibe setup and status commands

6e81655

feat: add algokit vibe setup to init flow to prompt user to install v…

aaff4c8

…ibekit if missing and run it to the generated project

docs: add documentation about algokit vibe new feature

d27c896

p2arthur changed the base branch from main to decoupling March 13, 2026 20:35

p2arthur added 2 commits March 13, 2026 13:52

chore: fix formatting for ruff linter

25f6d28

fix: fix mypy type errors on new algokit vibe command tests

bbdcaf4

p2arthur added 3 commits March 16, 2026 07:44

chore: update pyjwt version on lock file for solving known vulnerab

a34deb2

chore: format algokit vibe tests

175c22b

chore: fix remaining ruff linting errors

34163fa

aorumbayev reviewed Mar 17, 2026

View reviewed changes

aorumbayev requested changes Mar 17, 2026

View reviewed changes

aorumbayev reviewed Mar 17, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add vibekit to algokit cli + implement it to init #716

Add vibekit to algokit cli + implement it to init #716
p2arthur wants to merge 8 commits intodecouplingfrom
feat/vibe-algokit

p2arthur commented Mar 13, 2026 •

edited

Loading

Uh oh!

Ganainmtech commented Mar 16, 2026

Uh oh!

aorumbayev Mar 17, 2026

Uh oh!

aorumbayev left a comment •

edited

Loading

Uh oh!

aorumbayev Mar 17, 2026 •

edited

Loading

Uh oh!

aorumbayev Mar 17, 2026

Uh oh!

aorumbayev Mar 17, 2026

Uh oh!

aorumbayev Mar 17, 2026

Uh oh!

aorumbayev Mar 17, 2026

Uh oh!

aorumbayev Mar 17, 2026 •

edited

Loading

Uh oh!

aorumbayev left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		VIBEKIT_INSTALL_URL = "https://getvibekit.ai/install"


		@click.group("vibe", short_help="Give your AI assistant Algorand superpowers using VibeKit.")

		return ["sh", "-c", f"curl -fsSL {VIBEKIT_INSTALL_URL} \| sh"]


		def _build_vibekit_init_env() -> dict[str, str]:

Conversation

p2arthur commented Mar 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add algokit vibe spike + init prompt - Builds on top of decoupling branch

Uh oh!

Ganainmtech commented Mar 16, 2026

Uh oh!

aorumbayev Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

aorumbayev left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

aorumbayev Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

aorumbayev Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

aorumbayev Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

aorumbayev Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

aorumbayev Mar 17, 2026

Choose a reason for hiding this comment

Uh oh!

aorumbayev Mar 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

aorumbayev left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

p2arthur commented Mar 13, 2026 •

edited

Loading

aorumbayev left a comment •

edited

Loading

aorumbayev Mar 17, 2026 •

edited

Loading

aorumbayev Mar 17, 2026 •

edited

Loading