Add AI agent command to CLI

Author: GaspardKirira

CMakeLists.txt

@@ -105,6 +105,7 @@ else()
   set(_VIX_P2P_DIR      "${_VIX_MODULES_DIR}/p2p")
   set(_VIX_SYNC_DIR     "${_VIX_MODULES_DIR}/sync")
   set(_VIX_CACHE_DIR    "${_VIX_MODULES_DIR}/cache")
+  set(_VIX_AGENT_DIR    "${_VIX_MODULES_DIR}/agent")
 
   set(_LOCAL_LAYOUT_OK FALSE)
   if (EXISTS "${_VIX_CORE_DIR}/CMakeLists.txt" AND EXISTS "${_VIX_UTILS_DIR}/CMakeLists.txt")
@@ -146,6 +147,10 @@ else()
       add_subdirectory("${_VIX_CACHE_DIR}" "${CMAKE_BINARY_DIR}/_vix_cache")
     endif()
 
+    if (EXISTS "${_VIX_AGENT_DIR}/CMakeLists.txt" AND NOT TARGET vix::ai_agent)
+      add_subdirectory("${_VIX_AGENT_DIR}" "${CMAKE_BINARY_DIR}/_vix_ai_agent")
+    endif()
+
     if (EXISTS "${_VIX_P2P_DIR}/CMakeLists.txt" AND NOT TARGET vix::p2p)
       add_subdirectory("${_VIX_P2P_DIR}" "${CMAKE_BINARY_DIR}/_vix_p2p")
     endif()
@@ -186,6 +191,10 @@ else()
       list(APPEND _VIX_LOCAL_LINK_TARGETS vix::cache)
     endif()
 
+    if (TARGET vix::ai_agent)
+      list(APPEND _VIX_LOCAL_LINK_TARGETS vix::ai_agent)
+    endif()
+
     if (TARGET vix::p2p)
       list(APPEND _VIX_LOCAL_LINK_TARGETS vix::p2p)
     endif()
@@ -200,6 +209,7 @@ else()
     vix_append_if_exists(_VIX_LOCAL_INCLUDE_DIRS "${_VIX_CRYPTO_DIR}/include")
     vix_append_if_exists(_VIX_LOCAL_INCLUDE_DIRS "${_VIX_SYNC_DIR}/include")
     vix_append_if_exists(_VIX_LOCAL_INCLUDE_DIRS "${_VIX_CACHE_DIR}/include")
+    vix_append_if_exists(_VIX_LOCAL_INCLUDE_DIRS "${_VIX_AGENT_DIR}/include")
     vix_append_if_exists(_VIX_LOCAL_INCLUDE_DIRS "${_VIX_P2P_DIR}/include")
 
     if (_VIX_LOCAL_LINK_TARGETS)

include/vix/cli/commands/AgentCommand.hpp

@@ -0,0 +1,28 @@
+/**
+ *
+ *  @file AgentCommand.hpp
+ *  @author Gaspard Kirira
+ *
+ *  Copyright 2026, Gaspard Kirira.
+ *  All rights reserved.
+ *  https://github.com/vixcpp/vix
+ *
+ *  Use of this source code is governed by a MIT license
+ *  that can be found in the License file.
+ *
+ *  Vix.cpp
+ *
+ */
+#ifndef VIX_AGENT_COMMAND_HPP
+#define VIX_AGENT_COMMAND_HPP
+
+#include <string>
+#include <vector>
+
+namespace vix::commands::AgentCommand
+{
+  int run(const std::vector<std::string> &args);
+  int help();
+}
+
+#endif // VIX_AGENT_COMMAND_HPP

src/CLI.cpp

@@ -49,6 +49,7 @@
 #include <vix/cli/commands/CleanCommand.hpp>
 #include <vix/cli/commands/ResetCommand.hpp>
 #include <vix/cli/commands/TaskCommand.hpp>
+#include <vix/cli/commands/AgentCommand.hpp>
 #include <vix/utils/Env.hpp>
 #include <vix/cli/Style.hpp>
 #include <vix/utils/Logger.hpp>
@@ -282,6 +283,8 @@ namespace vix
     { return commands::ResetCommand::run(args); };
     commands_["task"] = [](auto args)
     { return commands::TaskCommand::run(args); };
+    commands_["agent"] = [](auto args)
+    { return commands::AgentCommand::run(args); };
 
     commands_["-h"] = [this](auto args)
     { return help(args); };