* fix(workspace): address PR #47 review feedback
- Use stable keys (item.label) instead of array indices in FileContextMenu
- Add clipboard feedback showing "Copied!" or "Failed" status
- Fix empty catch block in createFile to preserve error context
- Remove duplicate empty line in workspace page
- Remove unused MarkdownViewer component (replaced by FileEditor)
* refactor(workspace): streamline FileEditor layout and enhance responsiveness
- Simplified the FileEditor component by removing unused action buttons and restructuring the layout for better clarity.
- Updated styles for indicators and buttons to improve visual consistency and responsiveness across different screen sizes.
- Adjusted text sizes for better readability in various states (editing, saving, etc.) and ensured proper flex behavior for metadata display.
* style(workspace): update text sizes for indicators in FileEditor
- Increased font sizes for various indicators (Markdown, Editing, Unsaved, Saving, Saved, Save failed) to improve readability.
- Adjusted button visibility logic to only show the Save button when there are unsaved changes, enhancing user experience.
* feat(workspace): add file creation functionality in FileTree and NewFileDialog
- Introduced a button in the FileTree component to create new files within directories.
- Updated NewFileDialog to accept an optional folderPath prop, allowing file creation in specified directories.
- Enhanced WorkspacePage to manage folder paths for new file creation, improving user experience when organizing files.
* style(workspace): update file metadata display color in FileTree
- Modified the text color for file size metadata in the FileTree component to improve visual distinction based on selection state. The color now changes to a lighter shade when the file is selected, enhancing user experience and clarity.
* refactor(workspace): remove redundant editing indicator from FileEditor
- Eliminated the "Editing" mode indicator from the FileEditor component to streamline the UI. This change enhances clarity by focusing on the unsaved changes indicator, improving the overall user experience.
* style(workspace): refine flex properties and text wrapping in FileEditor
- Updated flex properties for various elements in the FileEditor component to enhance layout consistency and responsiveness.
- Improved text wrapping behavior for indicators and content areas, ensuring better readability and visual alignment across different screen sizes.
* style(workspace): update text weight in FileEditor for improved readability
- Changed font weight to 'light' for the text in the FileEditor component, enhancing visual clarity and consistency with the overall design.
* style(workspace): adjust flex properties and text sizes in FileTree
- Updated flex properties to remove redundant 'flex-shrink-0' classes, enhancing layout consistency.
- Increased font size for file metadata display to improve readability.
- Ensured consistent styling for folder and file icons, contributing to a cleaner UI.
* style(monitor): increase font sizes for improved readability across components
- Updated font sizes from 10px to 11px in various components including ActionNode, ExecNode, MobileMonitorToolbar, and others to enhance text clarity.
- Adjusted text sizes in the SettingsPanel and SessionList for consistency and better user experience.
- Ensured uniformity in font sizes across the monitor components to maintain a cohesive design.
* feat(workspace): add file editing capabilities with save, delete, and create operations
- Add FileEditor component replacing MarkdownViewer with save functionality
- Add ConfirmationDialog for destructive operations like file deletion
- Add FileContextMenu for right-click file operations (edit, copy path, delete)
- Add NewFileDialog for creating new files in the workspace
- Add tRPC procedures for writeFile, deleteFile, and createFile operations
- Enhance validatePath with symlink resolution to prevent path traversal attacks
- Integrate new file management features into workspace page with context menu support
* fix(workspace): correct file editor header layout and stretch edit to fill height of container
* fix(workspace): improve file editor header responsiveness and prevent overflow
Restructure header into three distinct sections (controls, filename/indicators,
metadata) with proper flex constraints and truncation behavior. Add responsive
visibility controls to hide secondary elements on small screens. Fix content
overflow issues in markdown and code block rendering with max-width constraints
and improved text wrapping.
- Updated instructions to emphasize brevity when communicating with users, ensuring they are not overwhelmed.
- Revised phrasing to enhance clarity in initiating feedback conversations, maintaining a conversational tone throughout.
- Removed the installation check for `qrencode` from the main installation steps to streamline the process.
- Added a new section detailing optional installation of `qrencode` for QR code display, with platform-specific commands for macOS, Debian/Ubuntu, Fedora, and Arch.
- Improved clarity and organization of installation instructions to enhance user experience.
- Add feedback skill for collecting user feedback via agents
- Feedback submitted as GitHub Issues with labels (bug, feature, general)
- Requires Crabwalk installation before feedback interview
- Agents prompt users for feedback after installation
- Capture issues during conversation as feedback
- Browse all feedback at https://crabwalk.app/#/feedback
- Added a new section for soliciting user feedback after initial use of Crabwalk, encouraging users to share their experiences.
- Introduced guidelines for capturing issues as feedback, outlining steps for assisting users and submitting feedback.
- Included resource links for submitting and browsing feedback to enhance user engagement and improve the feedback collection process.
- Updated language to encourage users to ask for assistance with installation rather than stating it directly.
- Enhanced conversational tone by rephrasing instructions to promote collaboration in the installation process.
- Maintained emphasis on the importance of having Crabwalk installed before proceeding with feedback collection.
- Revised the body field in the feedback JSON structure to encourage users to share details about the machine, location, and Crabwalk version number.
- Enhanced clarity and completeness of feedback submissions to improve the overall feedback process.
- Revised language to specify that the Crabwalk skill can assist with installation directly.
- Changed phrasing to enhance clarity and maintain a conversational tone, emphasizing collaboration in the installation process.
- Ensured users understand the importance of installation before proceeding with feedback collection.
- Introduced a new prerequisite section to ensure users verify Crabwalk installation before proceeding with feedback collection.
- Provided clear instructions for users on how to check for installation and what to communicate if Crabwalk is not installed.
- Emphasized the importance of not conducting interviews without Crabwalk being installed to enhance the feedback process.
- Updated language to maintain a conversational tone by consistently using "your human" instead of "the human" or "user."
- Added a new section to guide users on initiating feedback conversations with broad questions.
- Enhanced instructions for adapting questions based on responses and emphasized the importance of clarifying questions.
- Improved post-submission communication guidelines to ensure clarity in interactions with users.
- Enhanced language to promote a more conversational tone, replacing "user" with "human" for consistency.
- Added emphasis on asking clarifying questions and refining user feedback during interviews.
- Updated submission guidelines to ensure feedback is only submitted after confirming no further input from the human.
- Improved instructions for browsing feedback and post-submission communication.
- Introduced a new document outlining the Crabwalk Feedback Skill, detailing two feedback modes: User Research Interview and Quick Feedback.
- Provided guidelines for selecting a feedback mode, submitting feedback via API, and post-submission steps.
- Included notes on feedback processing and user interaction to enhance the feedback collection process.
- Simplified instructions for obtaining the gateway token, emphasizing automatic detection from the configuration file.
- Added manual retrieval options and explicit token setting commands for user convenience.
- Added detailed CLI usage section including commands, options, and examples for better user guidance.
- Included information on auto-detection of gateway token and QR code display on startup.
* feat: implement starred files functionality in workspace
- Added state management for starred files, allowing users to star and unstar files.
- Updated local storage handling to persist starred files across sessions.
- Enhanced sidebar to display starred files, with a collapsed view for better accessibility.
- Refactored sidebar animation logic for improved performance and user experience.
* feat: enhance FileTree component with starring functionality
- Added support for starring and unstarring files within the FileTree component.
- Integrated starred files state management in the WorkspacePage, persisting changes to local storage.
- Updated UI to display starred files in a dedicated section with both collapsed and expanded views.
- Refactored FileTree and FileTreeItem components to accommodate new props for starring functionality.
* refactor: remove starring functionality from FileTree and update MarkdownViewer
- Removed starred file management from FileTree and FileTreeItem components.
- Updated MarkdownViewer to include starring functionality with a star button.
- Adjusted WorkspacePage to handle starred files display and interactions.
- Cleaned up related props and UI elements for improved clarity and performance.
* feat: add mobile components and safe area padding for improved mobile experience
- Introduced MobileBottomToolbar, MobileFileDrawer, and MobilePathSheet components for enhanced mobile functionality.
- Updated WorkspacePage to conditionally render mobile components based on device type.
- Added safe area padding in styles.css to accommodate iOS devices.
* feat: update MobileBottomToolbar to include currentPath prop and enhance UI elements
- Added currentPath prop to MobileBottomToolbar for displaying the current workspace path.
- Improved button styles and layout for better mobile usability.
- Adjusted icon sizes and spacing for a more consistent appearance across buttons.
* fix: update text color in MobileBottomToolbar based on currentPath prop
- Changed text color in the MobileBottomToolbar to reflect the presence of currentPath, enhancing visual feedback for users.
- Ensured consistency in UI elements for improved user experience.
* feat: enhance MobilePathSheet and WorkspacePage with validation logic
- Added validatedPath and pathValid props to MobilePathSheet for improved path validation handling.
- Updated button states in MobilePathSheet and WorkspacePage to reflect path validation status, enhancing user feedback.
- Improved input styling and layout for better usability on mobile devices.
* feat: integrate NavTabs component into MonitorPage and WorkspacePage
- Replaced existing navigation tab implementation with the new NavTabs component for a consistent UI across pages.
- Simplified the navigation structure by removing redundant tab elements while maintaining connection status visibility.
* refactor: simplify SessionList component structure and improve UI transitions
- Replaced motion.button with a standard button for better performance.
- Enhanced header and search input visibility with smoother opacity transitions.
- Updated platform filter buttons to improve accessibility and visual feedback.
- Refactored session list rendering for improved animation consistency and clarity.
* refactor: improve SessionList and NavTabs components for better UI and functionality
- Enhanced SessionList component with improved header visibility and transition effects.
- Updated NavTabs to include dropdown functionality with better accessibility and user interaction.
- Refactored styles for both components to ensure consistency and responsiveness across different states.
* refactor: update NavTabs component styles for improved UI consistency
- Increased font size for terminal header and footer text for better readability.
- Removed decorative dots from the terminal header to streamline the design.
- Adjusted padding in the terminal footer for a more balanced layout.
* fix: remove workspace sidebar scrollbar
* feat: add mobile components to MonitorPage for enhanced mobile experience
- Introduced MobileSessionDrawer and MobileMonitorToolbar components for improved mobile functionality.
- Updated MonitorPage to conditionally render mobile components based on device type.
- Enhanced layout and state management for mobile interactions.
- Updated server startup instructions to emphasize sharing the network IP link instead of localhost.
- Added a new verification step for users to confirm access to the monitor link with their human.
- Included a prompt for users to encourage sharing feedback about Crabwalk.
* feat: add OpenClaw integration with client and persistence services
- Introduced ClawdbotClient for WebSocket communication with the OpenClaw gateway.
- Implemented persistence service for managing session, action, and execution event data.
- Added protocol definitions for request and response frames, chat and agent events.
- Created utility functions for parsing events and managing collections of sessions and actions.
- Included initial documentation for the OpenClaw repository structure and usage.
* refactor: update references from Clawdbot to OpenClaw
- Renamed instances of Clawdbot to OpenClaw across documentation and codebase.
- Updated file paths and configuration references to reflect the new OpenClaw integration.
- Adjusted WebSocket connection messages and error handling to align with OpenClaw terminology.
- Enhanced README and other documentation to provide accurate information regarding the OpenClaw setup and usage.
- Consolidated installation commands into a single step for clarity.
- Added verification step to check the installed version of Crabwalk.
- Updated instructions for starting the server and accessing the agent activity graph.
- Removed redundant sections and improved overall readability.
* feat: add crabwalk CLI
- bin/crabwalk: shell wrapper with start/stop/status/update commands
- daemon mode with --daemon flag
- auto-detect gateway token from ~/.clawdbot/clawdbot.json
- show network IPs on startup for remote access
- update skill.md and README with CLI usage
* auto-add ~/.local/bin to PATH during install
* support zsh PATH config
Add support for expanding tilde (~) to the user's home directory in workspace
path operations. This allows users to use shorthand paths like '~/Documents'
instead of full absolute paths when configuring their workspace.
- Added expandTilde() utility function with cross-platform support
- Updated validatePath to return expanded path for UI consumption
- Applied expansion to listDirectory and readFile operations
- Modified UI to store and display expanded absolute paths
Fix file tree not properly resetting when refreshing workspace directory. Add useEffect hook to reset children state when entry path changes, preventing stale data display. Update handleRefresh to properly clear cache before reload and handle cases where selected files are deleted during refresh. Remove children.length check from loadChildren to allow directory re-expansion after refresh.
Normalize path separators for consistent comparison across Windows and Unix systems. Fixes path traversal validation to handle backslash separators and corrects extension detection for dotfiles like .gitignore.
- Add normalizeForComparison helper to convert backslashes to forward slashes
- Fix isTextFile to properly handle files starting with dots
- Add getParentDirPath utility for cross-platform directory navigation
- Prevent false positives in path traversal detection on Windows
Add comprehensive workspace exploration functionality allowing users to browse and view files from the host filesystem. This feature enables inspection of AI agent workspace contents directly through the web interface.
- Add workspace-fs library for safe file system operations with path validation
- Create tRPC workspace router with directory listing and file reading endpoints
- Implement workspace UI components with directory tree navigation
- Add markdown file viewer with syntax highlighting
- Configure Docker volume mounting for ~/.openclaw/workspace access
- Update navigation with tab-based switching between Monitor and Workspace views
* feat(monitor): implement follow mode in ActionGraph for new nodes
- Added a follow mode feature that automatically pans the viewport to new nodes in the ActionGraph.
- Introduced a button to toggle follow mode, enhancing user experience by allowing users to track new nodes easily.
- Updated the ActionGraphInner component to manage viewport changes and node tracking effectively.
* feat(graph-layout): implement caching for spawn Y positions to prevent jitter
- Introduced a caching mechanism for spawn Y positions of child sessions to maintain stability during parent action accumulation.
- Updated the layoutGraph function to utilize cached values, reducing recalculation and improving layout consistency.
- Added cleanup logic to remove entries from the cache for sessions that no longer exist, ensuring efficient memory usage.
* style(ActionGraph): enhance follow mode button appearance
- Updated the styling of the follow mode button in the ActionGraphInner component to include a backdrop blur effect, improving visual feedback for users when the mode is active.
* refactor(clawdbot): update spawn inference logic
- Replaced parent session activity tracking with a pending spawns array to record Task tool calls.
- Adjusted the spawn inference window to 10 seconds, ensuring accurate tracking of recent Task calls.
- Enhanced the inferSpawnedBy function to utilize the new pending spawns structure for improved session mapping.
- Removed obsolete parent session activity tracking code for cleaner implementation.
* fix(clawdbot): normalize tool name handling in action tracking
- Updated the action tracking logic to convert tool names to lowercase for consistent comparison, ensuring accurate detection of 'Task' tool calls in both addAction and hydrateFromServer functions.
- Enhanced event parsing to process tool events more effectively, improving overall event handling and session state management.
* refactor(clawdbot): enhance spawn inference with parent session activity tracking
- Introduced a new Map to track recent parent session activity, providing a fallback for spawn inference when Task tool calls are not available.
- Updated the recordPendingSpawn and inferSpawnedBy functions to utilize this new tracking mechanism, improving the accuracy of session mapping.
- Enhanced the addAction and hydrateFromServer functions to incorporate parent session activity tracking, ensuring comprehensive spawn history management.
- Cleared parent session activity during collection resets to maintain data integrity.
* refactor(clawdbot): improve parent session action tracking for spawn inference
- Replaced the previous parent session activity tracking with a new structure to maintain a history of recent actions, allowing for more precise spawn inference.
- Updated the trackParentAction function to log actions with timestamps and manage a maximum history length.
- Modified the inferSpawnedBy function to utilize the new action history for better accuracy in linking subagents to their parent sessions.
- Adjusted the addAction and hydrateFromServer functions to reflect the new tracking mechanism, ensuring comprehensive session mapping.
- Cleared the action history during collection resets to maintain data integrity.
* style(monitor): adjust ActionGraph component dimensions
- Updated the ActionGraphInner component to include width and height styles, enhancing the layout and visual consistency of the graph representation.
- Revised the filtering logic for subagent sessions in the layoutGraph function to exclude empty sessions that lack associated actions or execs. This change enhances the accuracy of session representation in the graph layout by ensuring only relevant sessions are displayed.
- Improved the filtering logic for orphan subagents in the layoutGraph function. Subagent sessions are now validated against their parent sessions, ensuring only those with valid parents are included. Non-subagents are displayed if they lack a parent or have a valid one, enhancing the accuracy of session representation in the graph layout.
- Updated the graph layout logic to filter out orphan subagents, ensuring that sessions with a `spawnedBy` reference to non-existent parents are excluded from the layout. This improves the accuracy of session representation and enhances the overall stability of the graph layout.
* refactor(monitor): unify action node lifecycle in addAction function
- Updated the addAction function to consolidate the handling of action types (start, streaming, complete, error, aborted) into a single node per runId, improving data consistency and reducing redundancy.
- Enhanced the logic to ensure that all states for the same runId share one node ID, streamlining the update process and maintaining accurate session state representation.
* refactor(parser): streamline event handling for lifecycle and assistant streams
- Updated the agentEventToAction function to remove placeholder content for lifecycle events, relying on UI labels for clarity.
- Enhanced parseEventFrame to process assistant stream events, allowing for the inclusion of streaming content while maintaining lifecycle event handling.
- Improved overall event processing logic for better data consistency and clarity in session representation.
* fix(parser): enhance text handling in agentEventToAction and parseEventFrame
- Updated agentEventToAction to handle both 'text' type and string text properties for improved event processing.
- Modified parseEventFrame to accommodate the new structure of assistant stream events, ensuring accurate handling of streaming content.
- This change enhances the robustness of event parsing and improves data consistency across different event types.
* refactor(monitor): update ActionNode component for improved state representation
- Replaced the Play icon with Loader2 for the 'start' state to better reflect the action's progress.
- Adjusted border and background colors to enhance visual distinction for the 'start' state.
- Enabled animation for the 'start' state, improving user feedback during action execution.
* refactor(graph-layout): improve session sorting for stable layout representation
- Updated the sorting logic for rootSessions to use session keys instead of lastActivityAt, ensuring stable node positions during streaming and preventing unintended swaps in the layout.
