Local-First Session Management and Observability for Autonomous Coding Sessions with Google Jules

• Formal Approval Loop: Review and authorize the agent's proposed plan before execution begins.
• Interactive Correspondence: Provide real-time guidance and context to active sessions using the talk interface.
• Result-Oriented: Every session is designed to deliver a high-quality Pull Request as the primary deliverable.
• Agent Orchestration: Optimized for AI-to-AI collaboration with a structured command surface and stateful local Registry.

Clone the mirror and install as a global .NET tool:

git clone https://github.com/hsm207/Cleo-Public.git
cd Cleo-Public
dotnet pack Cleo.Cli/Cleo.Cli.csproj -c Release -o ./dist
dotnet tool install --global --add-source ./dist Cleo.Cli --version 0.1.0-alpha

Note: Ensure your system PATH includes the .NET tools directory (~/.dotnet/tools on Linux/macOS or %USERPROFILE%\.dotnet\tools on Windows).

1. Authentication

   Save your Jules API key to the local vault.

   cleo config auth login <api-key>

2. Repo Discovery

   Verify that Jules has access to your target repository.

   cleo config repos

3. New Session

   Create a task for Jules in a specific repository.

   cleo session new "Build a Binance listing sniper bot" --repo "sources/github/org/trader"

4. View Plan

   Review what the agent intends to do before it starts.

   cleo plan view <session-id>

5. Approve

   Authorize the agent to begin working on the plan.

   cleo plan approve <session-id> <plan-id>

6. Provide Feedback

   Send guidance or context to the active session.

   cleo talk <session-id> --message "Don't lose money."

7. Check-in

   Refresh the session's pulse and synchronize new activities.

   cleo session checkin <session-id>

8. Review the Log

   Inspect the newly synchronized activity history and agent thoughts.

   cleo log view <session-id>

9. Get Result

   Once the session is complete, the check-in command provides the final Pull Request link.

   cleo session checkin <session-id>

Built with Clean Architecture and DDD in .NET 10.