first commit: New project

CLAUDE.md

@@ -0,0 +1,128 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Memos CLI is a command-line tool for interacting with Memos (a self-hosted note-taking application) via its API. The project is in early development stage with minimal implementation.
+
+## Development Commands
+
+### Environment Setup
+```bash
+# Create virtual environment (Python 3.13 required)
+python -m venv .venv
+
+# Activate virtual environment
+# Windows:
+.venv\Scripts\activate
+# Unix/macOS:
+source .venv/bin/activate
+
+# Install project in development mode
+pip install -e .
+```
+
+### Running the Application
+```bash
+# Run main module
+python -m memoscli
+# or
+python main.py
+```
+
+## Architecture
+
+### Project Structure
+- `main.py` - Entry point with basic Memos API integration
+- `memos.py` - Main module file (currently minimal)
+- `src/send.py` - Memos API client implementation for content posting
+- `src/config.py` - Configuration management for .env file operations
+- `src/__init__.py` - Package initialization
+- `pyproject.toml` - Project configuration with dependencies
+- `.env` - Environment variables template (auto-generated if missing)
+- `examples/send_example.py` - API usage examples
+- `examples/config_example.py` - Configuration usage examples
+
+### Planned Features
+1. **Content submission**: `memos send <content> [--type <type>]`
+2. **AI-powered summaries**: `memos summary [--date <date>] [--tags <tags>]`
+3. **Configuration management**: `memos config set <key> <value>`
+
+### Required Environment Variables
+```
+MEMOS_BASE_URL=<your_memos_base_url>
+MEMOS_TOKEN=<your_token>
+MEMOS_AI_MODEL_NAME=<your_ai_model_name>
+MEMOS_AI_MODEL_API_KEY=<your_ai_model_api_key>
+MEMOS_AI_MODEL_API_URL=<your_ai_model_base_url>
+```
+
+### Technical Requirements
+- Python 3.13 (specified in `.python-version`)
+- Dependencies: `requests>=2.31.0`, `python-dotenv>=1.0.0`
+- Uses Memos API with Bearer token authentication
+- Environment variable configuration via python-dotenv
+
+### Implementation Status
+- ✅ **Memos API client**: Basic implementation in `src/send.py`
+- ✅ **Content posting**: Can send memos with content, visibility, and tags
+- ✅ **Connection testing**: Built-in connection validation
+- ✅ **Error handling**: Proper exception handling for API errors
+- 🔄 **CLI interface**: Basic implementation in `main.py`
+- ✅ **Configuration management**: Complete implementation in `src/config.py`
+- ⏳ **AI integration**: Planned but not implemented
+- ⏳ **Content summarization**: Planned but not implemented
+
+### Usage Examples
+
+#### Memos API 使用示例
+```python
+# 方法1：使用便捷函数
+from src.send import send_memo
+result = send_memo("内容", visibility="PRIVATE", tags=["标签1", "标签2"])
+
+# 方法2：使用API客户端类
+from src.send import MemosAPI
+api = MemosAPI()
+result = api.send_memo("内容", visibility="PUBLIC", tags=["测试"])
+```
+
+#### 配置管理使用示例
+```python
+# 方法1：使用ConfigManager类
+from src.config import ConfigManager
+config = ConfigManager()
+config.set('MEMOS_BASE_URL', 'https://memos.example.com')
+url = config.get('MEMOS_BASE_URL')
+config.show_config()
+
+# 方法2：使用便捷函数
+from src.config import set_config, get_config
+set_config('MEMOS_TOKEN', 'your-token-here')
+token = get_config('MEMOS_TOKEN')
+```
+
+#### 命令行配置管理
+```bash
+# 显示当前配置
+python src/config.py show
+
+# 设置配置项
+python src/config.py set MEMOS_BASE_URL https://memos.example.com
+python src/config.py set MEMOS_TOKEN your-token-here
+
+# 获取配置项
+python src/config.py get MEMOS_BASE_URL
+
+# 验证配置
+python src/config.py validate
+```
+
+## Development Notes
+
+This project now has a functional Memos API client implementation. The core functionality for content posting is complete and tested. Remaining work includes:
+- CLI argument parsing for command-line interface
+- AI model integration for tag recommendations and summarization
+- Enhanced configuration management
+- Testing framework setup