Stop re-exploring the same codebase You give an agent a compact, persistent map of a recurring corpus. It begins oriented while still checking current evidence for each task. cpp academy academy/topics/peek-orientation website/content-src/academy/course.mjs academy Stop re-exploring the same codebase
Unit 7 · Give agents memory and orientation

Stop re-exploring the same codebase

You give an agent a compact, persistent map of a recurring corpus. It begins oriented while still checking current evidence for each task.

AxAgentContextMap8 focused minutesNot started
Unit example (nearest native match)

See the idea in context

auto analyst = axllm::agent(signature, axllm::object({
    {"contextFields", axllm::array({"codebase"})},
    {"contextPolicy", axllm::object({{"preset", "adaptive"}, {"budget", "balanced"}})},
    {"contextMap", axllm::object({{"maxChars", 1800}, {"infiniteEvolve", false}, {"evolveSteps", 1}})},
}));
  1. Load prior orientation

    savedSnapshot carries useful structure learned on earlier successful runs.

  2. Keep the map compact

    maxChars bounds what is injected into the agent context.

  3. Use it as a guide

    The map points the agent toward evidence but never replaces current source.

Run itIn your own project
include(FetchContent)
FetchContent_Declare(axllm GIT_REPOSITORY https://github.com/ax-llm/ax GIT_TAG main SOURCE_SUBDIR packages/cpp)
FetchContent_MakeAvailable(axllm)
target_link_libraries(your_app PRIVATE axllm::axllm)

#include <axllm/axllm.hpp>

auto llm = axllm::ai("openai", axllm::object({{"apiKey", std::getenv("OPENAI_API_KEY")}}));
auto classify = axllm::ax("review:string -> sentiment:class \"positive, negative, neutral\"");

Set OPENAI_APIKEY in your environment before running provider-backed code.

In the ax repo

From a clone of the ax repo:

npm run example -- cpp src/examples/cpp/long-agents/codebase_peek_map.cpp
Active practice

Show that you can use it

Answer 2 in a row to learn this · attempt 1
Keep exploring

Source-backed follow-up