AI终端助手

# One-shot task
agent "check AAPL and MSFT stock prices and calculate the difference"

# Interactive mode — follow-up tasks with shared memory
agent -Interactive "research PowerShell async patterns"

# Pre-seed working memory
agent -Memory @{ budget = "5000" } "calculate 8% tax on the budget"

# The LLM can dynamically delegate during an agent run:
# Single sub-task
{"tool":"spawn_agent","task":"research PowerShell async patterns"}

# Parallel sub-tasks via thread jobs
{"tool":"spawn_agent","tasks":"[{\"task\":\"research X\"},{\"task\":\"research Y\"}]","parallel":"true"}

# Build a standalone .exe (defaults to PowerShell/WinForms lane)
build "a todo list app with categories and due dates"

# Force a specific framework
build python-tk "a calculator with scientific functions"
build python-web "a markdown editor with live preview"

# Override token budget for complex apps
build -tokens 32000 "a project management dashboard"

# Skip branding (future paid tier)
build -nobranding "a simple timer"

# List all builds
builds

# Modify an existing build with diff-based edits
rebuild my-todo-app "add a dark mode toggle"

plugins                        # List active & disabled plugins
Enable-BildsyPSPlugin 'Example'  # Activate a plugin
new-plugin 'MyPlugin'          # Scaffold from template
test-plugin -All               # Run plugin self-tests
watch-plugins                  # Auto-reload on file save
plugin-config Pomodoro          # View plugin configuration

{
  "skills": {
    "deploy_staging": {
      "description": "Pull latest and show status",
      "triggers": ["deploy staging", "push to staging"],
      "parameters": [{"name": "branch", "default": "main"}],
      "confirm": true,
      "steps": [
        {"command": "git checkout {branch}"},
        {"command": "git pull origin {branch}"},
        {"intent": "git_status"}
      ]
    }
  }
}

# Skills are directly callable from the prompt
deploy_staging                          # invoke by name
deploy_staging main                     # with positional args

# Or programmatically
Invoke-UserSkill -Name 'deploy_staging' -Parameters @{ branch = 'main' }

skills              # List user skills
new-skill 'name'    # Create interactively
reload-skills       # Reload from JSON

# List available workflows
workflows

# Run a workflow
workflow daily_standup
workflow research_and_document -Params @{ topic = "AI agents" }

# Stop on first failure
Invoke-Workflow -Name daily_standup -StopOnError

# AI can trigger via intent:
# {"intent":"run_workflow","name":"research_and_document","params":"{\"topic\":\"PowerShell\"}"}

# Start AI chat (local Ollama)
chat

# Start AI chat with Claude
chat -p anthropic

# Start with folder awareness (AI sees your current directory)
chat -FolderAware   # or: chat -f

# Resume last session with context recall
chat -Continue      # or: chat -c

# Show available commands
tips

# Check tool health
health

{
  "apiKeys": {
    "ANTHROPIC_API_KEY": "your-key-here",
    "OPENAI_API_KEY": "your-key-here"
  }
}

{
  "defaults": {
    "provider": "ollama",
    "model": "llama3.2"
  }
}

{
  "providers": {
    "anthropic": { "defaultModel": "claude-sonnet-4-6" }
  }
}

BildsyPS/
├── Microsoft.PowerShell_profile.ps1  # Main profile (loads modules)
├── ChatConfig.json                   # API keys and settings
├── ToolPreferences.json              # Tool preferences
├── NaturalLanguageMappings.json      # Command mappings
├── UserSkills.json                   # Custom user-defined intents (your file)
├── UserSkills.example.json           # Template for user skills
├── UserAliases.ps1                   # Your custom persistent aliases
├── BildsyPS.psm1                     # Module loader
├── BildsyPS.psd1                     # Module manifest
├── Modules/
│   ├── ConfigLoader.ps1              # .env and config loading
│   ├── PlatformUtils.ps1             # Cross-platform helpers
│   ├── SecurityUtils.ps1             # Path/URL security
│   ├── SecretScanner.ps1             # API key / credential leak detection
│   ├── CommandValidation.ps1         # Command whitelist & safety
│   ├── SystemUtilities.ps1           # uptime, hwinfo, ports, sudo, PATH
│   ├── ArchiveUtils.ps1              # zip, unzip
│   ├── DockerTools.ps1               # Docker shortcuts
│   ├── DevTools.ps1                  # IDE launchers, dev checks
│   ├── NaturalLanguage.ps1           # NL to command translation
│   ├── ResponseParser.ps1            # Parse AI responses, format markdown
│   ├── DocumentTools.ps1             # OpenXML document creation
│   ├── SafetySystem.ps1              # AI execution safety + secret scanning
│   ├── SystemCleanup.ps1             # Wrapped cleanup commands (flush DNS, restart explorer)
│   ├── TerminalTools.ps1             # bat, glow, broot, fzf integration
│   ├── NavigationUtils.ps1           # Navigation & git shortcuts
│   ├── PackageManager.ps1            # Tool installation
│   ├── WebTools.ps1                  # Web search APIs
│   ├── ProductivityTools.ps1         # Clipboard, Git, Calendar
│   ├── MCPClient.ps1                 # MCP protocol client
│   ├── BrowserAwareness.ps1          # Browser tab URL + content reading
│   ├── VisionTools.ps1               # Screenshot capture + vision model analysis
│   ├── OCRTools.ps1                  # Tesseract OCR + pdftotext integration
│   ├── CodeArtifacts.ps1             # AI code save + execute + tracking
│   ├── AppBuilder.ps1                # Prompt-to-executable pipeline (ps2exe, PyInstaller)
│   ├── FzfIntegration.ps1            # Fuzzy finder integration
│   ├── PersistentAliases.ps1         # User-defined aliases
│   ├── ProfileHelp.ps1               # Help, tips, system prompt
│   ├── FolderContext.ps1             # Folder awareness for AI context
│   ├── ToastNotifications.ps1        # BurntToast/.NET notifications
│   ├── ChatStorage.ps1               # SQLite persistence + FTS5 full-text search
│   ├── ChatSession.ps1               # LLM chat loop + session management
│   ├── ChatProviders.ps1             # AI provider implementations
│   ├── AgentHeartbeat.ps1            # Cron-triggered background agent tasks
│   ├── UserSkills.ps1                # JSON user-defined intent loader
│   ├── PluginLoader.ps1              # Plugin system (deps, config, hooks, tests)
│   ├── IntentAliasSystem.ps1         # Intent system orchestrator (loads below)
│   ├── IntentRegistry.ps1            # Intent metadata + category definitions
│   ├── IntentActions.ps1             # Core intent scriptblocks (docs, web, git, etc.)
│   ├── IntentActionsSystem.ps1       # System/filesystem/workflow/vision/build scriptblocks
│   ├── WorkflowEngine.ps1            # Multi-step workflow engine
│   ├── IntentRouter.ps1              # Intent router, help, tab completion
│   ├── AgentTools.ps1                # Agent tool registry (17 built-in tools incl. spawn_agent)
│   └── AgentLoop.ps1                 # Autonomous agent engine (ReAct + tools + memory + sub-agents)
├── Plugins/
│   ├── _Example.ps1                  # Reference plugin template
│   ├── _Pomodoro.ps1                 # Pomodoro timer plugin
│   ├── _QuickNotes.ps1               # Note-taking plugin
│   └── Config/                       # Per-plugin configuration overrides
├── Tests/                            # 17 Pester test files (368 tests)
├── README.md
├── VISION.md                         # Product direction and roadmap
├── CHANGELOG.md                      # Release history
├── CONTRIBUTING.md                   # Contributor guide
└── SETUP.md                          # Detailed setup instructions

chat -Resume        # or: chat -r  — resume last session
chat -Continue      # or: chat -c  — resume + inject summary so model recalls context
chat -FolderAware   # or: chat -f  — inject current directory on start, auto-update on cd
chat -AutoTrim      # automatically trim context when approaching model limits

# Windows
git clone https://github.com/gsultani1/BildsyPS.git "$HOME\Documents\PowerShell"

# macOS/Linux
git clone https://github.com/gsultani1/BildsyPS.git ~/.config/powershell

# Register common MCP servers
mcp-register

# List registered servers
mcp-servers

# Connect to a server
mcp-connect filesystem

# Call a tool
mcp-call -ServerName filesystem -ToolName read_file -Arguments @{path="C:\file.txt"}

Register-MCPServer -Name "myserver" `
    -Command "npx" `
    -Args @("-y", "@org/mcp-server-name") `
    -Description "My custom server"