@bniladridas/cursor 0.1.18 → 0.1.20

package/.github/workflows/ci.yml

@@ -115,6 +115,8 @@ jobs:
           sudo apt update
           sudo apt install -y nlohmann-json3-dev cmake build-essential libcurl4-openssl-dev libpqxx-dev lcov
           cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug
+          cmake --build build --target cursor-agent
+          chmod +x build/bin/cursor-agent || true
           cmake --build build --target coverage
       - uses: codecov/codecov-action@v7
         with:

package/.github/workflows/release.yml

@@ -71,6 +71,7 @@ jobs:
           # build bottle
           mkdir -p bottle/cursor/${version}/bin
           cp ../build/bin/cursor-agent bottle/cursor/${version}/bin/cursor-agent
+          ln -s cursor-agent bottle/cursor/${version}/bin/cursor
           cp ../.env.example bottle/cursor/${version}/.env.example
           tar -C bottle -czf cursor-${version}.arm64_sequoia.bottle.tar.gz cursor
 

package/AGENTS.md

@@ -1,49 +1,79 @@
-# Cursor
+# Cursor Runtime Help
 
-C++20 AI coding agent. 16 services, 8 AI providers, CI/CD across 3 platforms.
+This file is the live runtime help source for the Cursor agent.
 
-## Build & Test
+Use `/help` or `/docs` to display this content at runtime. If this file cannot be loaded,
+the agent falls back to built-in help output.
 
-```bash
-cmake -S . -B build && cmake --build build
-./build/cursor-tests   # unit tests
-```
+## Available Meta Commands
 
-## Style
+- `/help` or `/?` - Show runtime help
+- `/docs` - Show runtime help
+- `/debug` - Toggle verbose/debug mode (shows all agent reasoning)
+- `/tools` - Show available tools
+- `/clear` - Clear screen
+- `/chat save <tag>` - Save conversation state
+- `/chat resume <tag>` - Resume conversation state
+- `/chat list` - List saved conversations
+- `/memory show` - Show memory context
+- `/memory add <text>` - Add a fact to memory
+- `/compress` - Compress conversation context
+- `/stats` - Show session statistics
+- `/context show` - Show hierarchical context
+- `/context refresh` - Refresh context cache
+- `/context create` - Create `CURSOR.md`
+- `/files <patterns>` - Read multiple files via glob or path patterns
+- `/fetch <url> [format]` - Fetch web content (text/json/raw)
+- `/checkpoint <cmd>` - Manage checkpoints (create/list/delete)
+- `/restore [id]` - List or restore checkpoints
+- `/mcp <cmd>` - MCP server management
+- `/theme <cmd>` - Theme management
+- `/auth <cmd>` - Authentication management
+- `/sandbox <cmd>` - Sandboxed execution management
+- `/error <cmd>` - Error management and reporting
+- `/goal show` - Show the current goal and task status
+- `/goal clear` - Clear current goal, tasks, and params
+- `/task add <description>` - Add a task for the current goal
+- `/task list` - List active tasks
+- `/task complete <id>` - Mark a task complete
+- `/task remove <id>` - Remove a task
+- `/params set key=value` - Set goal/task parameters
+- `/params show` - Show current parameters
+- `/params clear` - Clear current parameters- `/github repo:owner/repo` - Repository info
+- `/github issues:owner/repo` - List repository issues
+- `/github health:owner/repo` - Run repository health check
+- `/quit` or `/exit` - Exit the program
 
-- C++20: `starts_with()`, `std::optional`, structured bindings
-- `snake_case` for functions, `PascalCase` for classes
-- Static service methods - no state (except `AIService`, `DatabaseService`)
-- No exceptions in hot paths - return `std::optional` or error codes
-- No raw pointers - RAII wrappers or `unique_ptr`
-- `#pragma once` in headers, `#ifdef _WIN32` for platform code
+## File Injection
 
-## Workflow
+- `@<path>` - Include file or directory content in the prompt
+- Example: `@src/main.cpp What does this code do?`
 
-`plan → implement → build → test → fix → cleanup → continue`
+## Shell Commands
 
-Detect stale, duplicated, or dead code as you go. Fix warnings and failing tests immediately. Keep dependencies and config clean. Don't remove things that serve a purpose.
+- `!<command>` - Execute shell command
+- `!` - Toggle shell mode
+- `build:command` - Execute build or shell commands
 
-## Technical Debt
+## Direct Commands
 
-- `agent.cpp` (76KB) - God class, main refactoring target
-- 2 unit tests - far below where we need to be
+- `cmd:<command>` - Execute shell command safely
+- `read:<file>[:start:count]` - Read file contents
+- `write:<file> <content>` - Write content to a file
+- `replace:<file>:<old>:<new>[:expected_count]` - Replace text in a file
+- `grep:<pattern>[:directory[:file_filter]]` - Search text in files
+- `search:<query>` - Search the web
+- `remember:<fact>` - Save a fact to memory
+- `analyze:<path>` - Analyze project structure
+- `components:<path>` - Find main components
+- `todos:<path>` - Find task comments
+- `tree:<path>` - Show directory tree
+- `git:log` - Show git history
+- `git:status` - Show git status
+- `git:analyze` - Analyze git repository
 
-## Hard Rules
+## Runtime Help Integration
 
-- No new files unless explicitly told
-- No comments in code unless necessary
-- No new dependencies
-- No documentation files unless asked
+This file is the single live runtime help document for cursor.
 
-## GitHub Secrets Required
-
-| Secret | Used By | Purpose |
-|--------|---------|---------|
-| `NPM_TOKEN` | release.yml | Publish @bniladridas/cursor |
-| `DOCKER_USERNAME` | ci.yml | Push Docker images |
-| `DOCKER_PASSWORD` | ci.yml | Push Docker images |
-| `CLA_BOT_TOKEN` | cla.yml | CLA comment bot |
-| `CLA_SIGNED_JSON` | cla.yml | Signed CLA storage path |
-| `CURSOR_BOT_CLIENT_ID` | formula-sha.yml | GitHub App for PR creation |
-| `CURSOR_BOT_PRIVATE_KEY` | formula-sha.yml | GitHub App for PR creation |
+Do not add an additional runtime help file.

package/CMakeLists.txt

@@ -72,6 +72,7 @@ endif()
 
 # Find dependencies
 find_package(Threads REQUIRED)
+find_library(EDIT_LIBRARY edit)
 
 # Find zlib with platform-specific logic, fallback to FetchContent
 set(zlib_is_found FALSE)
@@ -137,13 +138,21 @@ find_package(CURL REQUIRED)
 set(openssl_is_found FALSE)
 if(APPLE)
     set(CMAKE_OSX_ARCHITECTURES "arm64" CACHE STRING "Build architectures for macOS" FORCE)
-    # Set deployment target based on environment
     if(DEFINED ENV{CI} OR DEFINED ENV{GITHUB_ACTIONS})
-        # Use compatible version for CI environments
         set(CMAKE_OSX_DEPLOYMENT_TARGET "14.0" CACHE STRING "Minimum macOS version" FORCE)
     else()
-        # Use current system version to avoid linker warnings with Homebrew libraries
-        set(CMAKE_OSX_DEPLOYMENT_TARGET "14.0" CACHE STRING "Minimum macOS version" FORCE)
+        execute_process(
+            COMMAND sw_vers -productVersion
+            OUTPUT_VARIABLE MACOS_PRODUCT_VERSION
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+        string(REGEX MATCH "^[0-9]+\\.[0-9]+" MACOS_DEPLOYMENT_VERSION "${MACOS_PRODUCT_VERSION}")
+        if(MACOS_DEPLOYMENT_VERSION)
+            set(CMAKE_OSX_DEPLOYMENT_TARGET "${MACOS_DEPLOYMENT_VERSION}" CACHE STRING "Minimum macOS version" FORCE)
+        else()
+            set(CMAKE_OSX_DEPLOYMENT_TARGET "14.0" CACHE STRING "Minimum macOS version" FORCE)
+        endif()
     endif()
 
     # Use Homebrew's OpenSSL on macOS/arm64
@@ -246,7 +255,7 @@ if(PQXX_LIBRARY AND PQXX_INCLUDE_DIR)
     message(STATUS "Found libpqxx: ${PQXX_LIBRARY}")
 else()
     set(HAVE_PQXX FALSE)
-    message(WARNING "libpqxx not found. Database support will be disabled. Install libpqxx-dev to enable PostgreSQL support.")
+    message(STATUS "libpqxx not found. Database support will be disabled.")
 endif()
 
 # Find CPR - try to find the package first
@@ -347,6 +356,14 @@ if(CURSOR_BUILD_TESTS)
 
          FetchContent_MakeAvailable(googletest)
 
+        if(CMAKE_CXX_COMPILER_ID MATCHES "Clang")
+            foreach(GTEST_TARGET gtest gtest_main gmock gmock_main)
+                if(TARGET ${GTEST_TARGET})
+                    target_compile_options(${GTEST_TARGET} PRIVATE -Wno-character-conversion)
+                endif()
+            endforeach()
+        endif()
+
         if(NOT TARGET gtest_all_tests)
             add_library(gtest_all_tests INTERFACE)
             target_link_libraries(gtest_all_tests
@@ -502,6 +519,11 @@ target_link_libraries(cursor_lib PRIVATE
     $<$<BOOL:${HAVE_PQXX}>:${PQXX_LIBRARY}>
 )
 
+if(EDIT_LIBRARY)
+    target_compile_definitions(cursor_lib PRIVATE CURSOR_USE_LIBEDIT)
+    target_link_libraries(cursor_lib PRIVATE ${EDIT_LIBRARY})
+endif()
+
 # Set additional linker flags for macOS
 if(APPLE)
     target_link_options(cursor_lib PRIVATE -stdlib=libc++)
@@ -530,6 +552,10 @@ if(CURSOR_BUILD_TESTS)
         gtest
     )
     add_test(NAME basic_tests COMMAND cursor-tests)
+    add_test(
+        NAME local_batch_e2e
+        COMMAND bash ${CMAKE_SOURCE_DIR}/tests/e2e/run_local_batch.sh $<TARGET_FILE:cursor-agent>
+    )
 
     set_target_properties(cursor-tests PROPERTIES
         RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}"
@@ -594,27 +620,45 @@ include(CPack)
 
 
 
+set(CURSOR_CHECK_TEST_COMMANDS "")
+set(CURSOR_CHECK_DEPENDS cursor-agent)
+if(CURSOR_BUILD_TESTS)
+    list(APPEND CURSOR_CHECK_TEST_COMMANDS COMMAND ${CMAKE_BINARY_DIR}/cursor-tests)
+    list(APPEND CURSOR_CHECK_TEST_COMMANDS COMMAND bash ${CMAKE_SOURCE_DIR}/tests/e2e/run_local_batch.sh $<TARGET_FILE:cursor-agent>)
+    list(APPEND CURSOR_CHECK_DEPENDS cursor-tests)
+endif()
+
 # Add custom check target for testing and validation
 add_custom_target(check
     COMMAND ${CMAKE_COMMAND} --build ${CMAKE_BINARY_DIR} --target cursor-agent
     COMMAND echo "Running automated tests..."
-    COMMAND printf "2\\nversion\\nhelp\\nexit\\n" | ${CMAKE_BINARY_DIR}/bin/cursor-agent
+    COMMAND $<TARGET_FILE:cursor-agent> --version
+    COMMAND $<TARGET_FILE:cursor-agent> --help
+    ${CURSOR_CHECK_TEST_COMMANDS}
     COMMAND echo "Checking binary exists..."
-    COMMAND test -f ${CMAKE_BINARY_DIR}/bin/cursor-agent
+    COMMAND test -f $<TARGET_FILE:cursor-agent>
     COMMAND echo "Validating executable permissions..."
-    COMMAND test -x ${CMAKE_BINARY_DIR}/bin/cursor-agent
+    COMMAND test -x $<TARGET_FILE:cursor-agent>
     COMMAND echo "All checks passed!"
-    DEPENDS cursor-agent
+    DEPENDS ${CURSOR_CHECK_DEPENDS}
     COMMENT "Running comprehensive project validation"
 )
 
 # Add quick test target
 add_custom_target(test-quick
-    COMMAND printf "2\\nexit\\n" | ${CMAKE_BINARY_DIR}/bin/cursor-agent
+    COMMAND printf "2\\nexit\\n" | $<TARGET_FILE:cursor-agent>
     DEPENDS cursor-agent
     COMMENT "Quick functionality test"
 )
 
+if(CURSOR_BUILD_TESTS)
+    add_custom_target(e2e-local
+        COMMAND bash ${CMAKE_SOURCE_DIR}/tests/e2e/run_local_batch.sh $<TARGET_FILE:cursor-agent>
+        DEPENDS cursor-agent
+        COMMENT "Running local batch E2E checks"
+    )
+endif()
+
 # Clang-Tidy target (disabled)
 # if(CLANG_TIDY_EXE)
 #     add_custom_target(clang-tidy