update README and docs

Author: TimeLovercc

README.md

@@ -13,6 +13,47 @@
 
 Have Claude Code Pro but not using it at night? Transform it into an AgentOS that handles your ideas and tasks while you sleep. This is a 24/7 AI assistant daemon powered by Claude Code CLI and Python Agent SDK that processes both random thoughts and serious tasks via Slack with isolated workspaces.
 
+## 📰 News
+
+- **[2025-10-26]** 🎉 Initial release v0.1.0 - Full AgentOS with multi-agent workflow support
+- **[2025-10-25]** 🚀 Added task auto-generation with configurable strategies
+- **[2025-10-24]** 🔧 Integrated Git management with automatic PR creation
+- **[2025-10-23]** 📊 Implemented isolated workspaces for parallel task execution
+- **[2025-10-22]** 💡 Added Claude Code Python Agent SDK integration
+
+## 🎬 Demo
+
+<div align="center">
+  <img src="assets/cli.png" alt="Sleepless Agent CLI Demo" width="800">
+  <p><em>Sleepless Agent CLI in action - managing tasks, checking status, and generating reports</em></p>
+</div>
+
+### Quick Example
+
+```bash
+# Start the daemon
+$ sle daemon
+2025-10-26 03:30:12 | INFO | Sleepless Agent starting...
+2025-10-26 03:30:12 | INFO | Slack bot connected
+
+# Submit a task via Slack
+/think Implement OAuth2 authentication -p backend
+
+# Check status
+$ sle check
+╭─────────────────── System Status ───────────────────╮
+│ 🟢 Daemon: Running                                  │
+│ 📊 Queue: 3 pending, 1 in_progress                  │
+│ 💻 Usage: 45% (Day threshold: 95%)                  │
+│ 🔄 Last task: "Implement OAuth2..." (in progress)   │
+╰─────────────────────────────────────────────────────╯
+
+# View results
+$ sle report 42
+Task #42: ✅ Completed
+Branch: feature/backend-42
+PR: https://github.com/user/repo/pull/123
+```
 
 ## ✨ Features
 
@@ -245,6 +286,69 @@ The agent automatically monitors Claude Code usage and intelligently manages tas
 - 📋 Pending tasks wait in queue
 - ⏱️ Automatic resume when usage resets
 
+### Git Management
+
+The agent integrates deeply with Git for automatic version control and collaboration:
+
+**Remote Repository Configuration (`config.yaml`):**
+- `git.use_remote_repo`: Enable/disable remote repository integration
+- `git.remote_repo_url`: Your remote repository URL (e.g., `[email protected]:username/repo.git`)
+- `git.auto_create_repo`: Automatically create repository if it doesn't exist
+
+**Git Workflow:**
+- **Random Thoughts**: Auto-commits to `thought-ideas` branch
+- **Serious Tasks (-p flag)**: Creates feature branches (`feature/<project>-<task_id>`) and opens PRs
+- **Automatic Commits**: Each task completion triggers a commit with descriptive messages
+- **PR Creation**: Serious tasks automatically create pull requests for review
+
+**Important:** Update `git.remote_repo_url` in `config.yaml` before running the agent!
+
+### Multi-Agent Workflow
+
+The agent employs a sophisticated multi-agent architecture for complex task processing:
+
+**Agent Types (`config.yaml`):**
+- **Planner Agent**: Analyzes tasks and creates execution plans (max 3 turns by default)
+- **Worker Agent**: Executes the planned tasks (max 3 turns by default)
+- **Evaluator Agent**: Reviews and validates completed work (max 3 turns by default)
+
+**Configuration:**
+```yaml
+multi_agent_workflow:
+  planner:
+    enabled: true
+    max_turns: 3
+  worker:
+    enabled: true
+    max_turns: 3
+  evaluator:
+    enabled: true
+    max_turns: 3
+```
+
+Each agent can be independently enabled/disabled and configured with different turn limits to control execution depth.
+
+### Task Auto-Generation
+
+The agent can automatically generate tasks to keep itself productive during idle time:
+
+**Generation Strategies (`config.yaml`):**
+- **refine_focused (45% weight)**: Focuses on completing or improving existing work
+- **balanced (35% weight)**: Mix of refinements and new tasks based on workspace state
+- **new_friendly (20% weight)**: Prioritizes creating innovative new projects
+
+**Task Types:**
+- **[NEW]**: Creates a new task in an isolated workspace (`workspace/tasks/<task_id>/`)
+- **[REFINE:#<id>]**: Improves specific existing task (reuses task workspace)
+- **[REFINE]**: General refinement of workspace projects
+
+**Workspace Constraints:**
+- Each task executes in its own isolated directory
+- Tasks only access their workspace and `workspace/shared/`
+- System directories (`workspace/data/`) are protected
+- REFINE tasks reuse existing workspaces for continuity
+
+
 ## 🔧 Environment Variables
 
 ```bash
@@ -253,6 +357,8 @@ SLACK_BOT_TOKEN=xoxb-...
 SLACK_APP_TOKEN=xapp-...
 ```
 
+**Note:** Most configuration is done via `config.yaml`. Environment variables are primarily for secrets and deployment-specific settings.
+
 ## 📝 Task Types
 
 The agent intelligently processes different task types:
@@ -265,53 +371,12 @@ The agent intelligently processes different task types:
 
 2. **Serious Tasks** - Creates feature branch and PR, requires review (use `-p` flag)
    ```
-   /think Add authentication to user service -p backend
-   /think Refactor payment processing module -p payments
+   /think -p backend Add authentication to user service
+   /think -p payments Refactor payment processing module
    ```
 
-## 🛠️ Development
-
-### Add New Task Type
-
-Edit task prompt configuration as needed in `daemon.py` or implement custom executors.
-
-### Database Schema
-
-Tasks are stored with:
-- `id`: Auto-incremented task ID
-- `description`: Task text
-- `priority`: "random" or "serious"
-- `status`: "pending", "in_progress", "completed", "failed"
-- `created_at`, `started_at`, `completed_at`: Timestamps
-- `result_id`: Link to Result record
-
-### Testing
-
-```bash
-# Run tests
-pytest
-
-# Run with debug logging
-SLEEPLESS_LOG_LEVEL=DEBUG python -m sleepless_agent.daemon
-```
-
 ## 📊 Monitoring
 
-### Real-time Logs
-```bash
-tail -f workspace/data/agent.log
-```
-
-### Database Queries
-```bash
-sqlite3 workspace/data/tasks.db "SELECT * FROM tasks WHERE status='completed' LIMIT 5;"
-```
-
-### Performance History
-```bash
-tail -100 workspace/data/metrics.jsonl | jq .
-```
-
 ### Slack Commands
 ```
 /check    # System status and performance stats
@@ -355,39 +420,77 @@ launchctl list | grep sleepless
 /think Performance analysis of payment module -p payments
 ```
 
-## 🔍 Troubleshooting
-
-| Issue | Solution |
-|-------|----------|
-| Bot not responding | Check `.env` tokens, verify Socket Mode enabled, check logs: `tail -f workspace/data/agent.log` |
-| Tasks not executing | Verify Claude Code CLI installed: `npm list -g @anthropic-ai/claude-code`, check workspace permissions |
-| Tasks paused (threshold reached) | Usage has reached time-based threshold (20% daytime / 80% nighttime). Wait for window reset (check logs for reset time), or adjust thresholds in `config.yaml` (`claude_code.threshold_day` / `claude_code.threshold_night`). Run `sle check` to see current usage. |
-| Git commits fail | Install `gh` CLI and authenticate: `gh auth login` |
-| Out of credits | Wait for 5-hour window refresh. Review scheduler logs: `tail -f workspace/data/agent.log | grep credit` |
-| Database locked | Close other connections, try: `rm workspace/data/tasks.db && python -m sleepless_agent.daemon` |
-
 ## ⚡ Performance Tips
 
 1. **Use thoughts to fill idle time** - Maximizes usage
 2. **Batch serious tasks** - Reduces context switching
-3. **Monitor credits** - Watch scheduler logs for window resets
+3. **Monitor usage** - Watch scheduler logs for usage patterns
 4. **Review git history** - Check `thought-ideas` branch regularly
 5. **Check metrics** - Run `sle check` to track performance
 
-## 🔒 Security Notes
-
-- Secrets are validated before git commits
-- Python syntax checked before commits
-- Directory traversal prevented in file operations
-- .env file never committed to git
-- Workspace changes validated before applying
-
 ## 📦 Releases
 
 - Latest stable: **0.1.0** – published on [PyPI](https://pypi.org/project/sleepless-agent/0.1.0/)
 - Install or upgrade with `pip install -U sleepless-agent`
 - Release notes tracked via GitHub Releases (tag `v0.1.0` onward)
 
+## 📚 Documentation
+
+For more detailed information and guides:
+
+- **[Full Documentation](https://context-machine-lab.github.io/sleepless-agent/)** - Complete documentation site
+- **[DeepWiki](https://deepwiki.com/context-machine-lab/sleepless-agent)** - Interactive knowledge base
+- **[Installation Guide](docs/installation.md)** - Detailed setup instructions
+- **[Quick Start](docs/quickstart.md)** - Get up and running quickly
+- **[FAQ](docs/faq.md)** - Frequently asked questions
+- **[Troubleshooting](docs/troubleshooting.md)** - Common issues and solutions
+
+## 🗺️ Roadmap
+
+- [ ] **Advanced Scheduling** - Priority queue with time-based and dependency scheduling
+- [ ] **Daily Report** - Daily report of the agent's work
+
+## 🙏 Acknowledgements
+
+We are deeply grateful to the open-source community and the projects that make Sleepless Agent possible:
+
+- **[Claude Code CLI](https://github.com/anthropics/claude-code)** - For providing the powerful foundation for AI-assisted development and the Python Agent SDK that enables seamless integration
+- **[Slack Bolt](https://github.com/slackapi/bolt-python)** - For reliable real-time messaging and command handling that powers our Slack integration
+- **[SQLAlchemy](https://www.sqlalchemy.org/)** - For robust data persistence and elegant ORM that manages our task queue
+- **[Rich](https://github.com/Textualize/rich)** - For beautiful terminal rendering that makes logs and outputs visually appealing
+- **[GitPython](https://github.com/gitpython-developers/GitPython)** - For comprehensive Git operations that enable our automated version control workflows
+
+## 🤝 Contributing
+
+We welcome contributions! Sleepless Agent is designed to be a community resource for 24/7 AI development automation.
+
+Please see our [Contributing Guidelines](CONTRIBUTING.md) for:
+- Development setup and environment configuration
+- Code style and testing requirements
+- How to submit pull requests
+- Community guidelines and code of conduct
+
+Feel free to:
+- 🐛 [Report bugs](https://github.com/context-machine-lab/sleepless-agent/issues/new?labels=bug)
+- 💡 [Suggest features](https://github.com/context-machine-lab/sleepless-agent/issues/new?labels=enhancement)
+- 💬 [Ask questions](https://github.com/context-machine-lab/sleepless-agent/discussions)
+- 🔧 [Submit pull requests](https://github.com/context-machine-lab/sleepless-agent/pulls)
+
+## 📖 Citation
+
+If you use Sleepless Agent in your research or projects, please cite:
+
+```bibtex
+@software{sleepless_agent_2025,
+  title = {Sleepless Agent: A 24/7 AgentOS for Continuous Development},
+  author = {Context Machine Lab},
+  year = {2025},
+  publisher = {GitHub},
+  journal = {GitHub repository},
+  url = {https://github.com/context-machine-lab/sleepless-agent}
+}
+```
+
 ## 📄 License
 
 Released under the [MIT License](LICENSE)